Batch API

Gemini API ব্যাচ API সমর্থন করে, যা আপনাকে একক কলে একাধিক অনুরোধ প্রক্রিয়া করতে দেয়। আরো বিস্তারিত জানার জন্য, ব্যাচ API গাইড দেখুন।

পদ্ধতি: models.batchGenerateContent

ব্যাচ প্রক্রিয়াকরণের জন্য models.generateContent অনুরোধের একটি ব্যাচ সারিবদ্ধ করে।

শেষবিন্দু

পোস্ট https: / /generativelanguage.googleapis.com /v1beta /{batch.model=models /*}:batchGenerateContent

পাথ প্যারামিটার

batch.model string

প্রয়োজন। সমাপ্তি তৈরি করার জন্য ব্যবহার করা Model নাম।

বিন্যাস: models/{model} । এটি ফর্ম models/{model} লাগে।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

ক্ষেত্র
batch.name string

শুধুমাত্র আউটপুট। শনাক্তকারী। ব্যাচের সম্পদের নাম।

বিন্যাস: batches/{batchId} ।

batch.displayName string

প্রয়োজন। এই ব্যাচের ব্যবহারকারী-সংজ্ঞায়িত নাম।

batch.inputConfig object ( InputConfig )

প্রয়োজন। ইনপুট কনফিগারেশন যেখানে ব্যাচ প্রক্রিয়াকরণ সঞ্চালিত হয়.

batch.output object ( GenerateContentBatchOutput )

শুধুমাত্র আউটপুট। ব্যাচের অনুরোধের আউটপুট।

batch.createTime string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে ব্যাচ তৈরি হয়েছিল।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

batch.endTime string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে ব্যাচ প্রক্রিয়াকরণ সম্পন্ন হয়েছে।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

batch.updateTime string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে ব্যাচ শেষ আপডেট করা হয়েছিল।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

batch.batchStats object ( BatchStats )

শুধুমাত্র আউটপুট। ব্যাচ সম্পর্কে পরিসংখ্যান.

batch.state enum ( BatchState )

শুধুমাত্র আউটপুট। ব্যাচের অবস্থা।

batch.priority string ( int64 format)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। একটি উচ্চ অগ্রাধিকার মান সঙ্গে ব্যাচ একটি নিম্ন অগ্রাধিকার মান সঙ্গে ব্যাচ আগে প্রক্রিয়া করা হবে. নেতিবাচক মান অনুমোদিত. ডিফল্ট 0।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে Operation একটি উদাহরণ থাকে।

পদ্ধতি: models.asyncBatchEmbedContent

ব্যাচ প্রক্রিয়াকরণের জন্য models.embedContent অনুরোধের একটি ব্যাচ সারিবদ্ধ করে। GenerativeService এ আমাদের একটি models.batchEmbedContents হ্যান্ডলার আছে, কিন্তু এটি সিঙ্ক্রোনাইজ করা হয়েছে। তাই আমরা বিভ্রান্তি এড়াতে এটির নাম Async রাখি।

শেষবিন্দু

পোস্ট https: / /generativelanguage.googleapis.com /v1beta /{batch.model=models /*}:asyncBatchEmbedContent

পাথ প্যারামিটার

batch.model string

প্রয়োজন। সমাপ্তি তৈরি করার জন্য ব্যবহার করা Model নাম।

বিন্যাস: models/{model} । এটি ফর্ম models/{model} লাগে।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

ক্ষেত্র
batch.name string

শুধুমাত্র আউটপুট। শনাক্তকারী। ব্যাচের সম্পদের নাম।

বিন্যাস: batches/{batchId} ।

batch.displayName string

প্রয়োজন। এই ব্যাচের ব্যবহারকারী-সংজ্ঞায়িত নাম।

batch.inputConfig object ( InputEmbedContentConfig )

প্রয়োজন। ইনপুট কনফিগারেশন যেখানে ব্যাচ প্রক্রিয়াকরণ সঞ্চালিত হয়.

batch.output object ( EmbedContentBatchOutput )

শুধুমাত্র আউটপুট। ব্যাচের অনুরোধের আউটপুট।

batch.createTime string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে ব্যাচ তৈরি হয়েছিল।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

batch.endTime string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে ব্যাচ প্রক্রিয়াকরণ সম্পন্ন হয়েছে।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

batch.updateTime string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে ব্যাচ শেষ আপডেট করা হয়েছিল।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

batch.batchStats object ( EmbedContentBatchStats )

শুধুমাত্র আউটপুট। ব্যাচ সম্পর্কে পরিসংখ্যান.

batch.state enum ( BatchState )

শুধুমাত্র আউটপুট। ব্যাচের অবস্থা।

batch.priority string ( int64 format)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। একটি উচ্চ অগ্রাধিকার মান সঙ্গে ব্যাচ একটি নিম্ন অগ্রাধিকার মান সঙ্গে ব্যাচ আগে প্রক্রিয়া করা হবে. নেতিবাচক মান অনুমোদিত. ডিফল্ট 0।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে Operation একটি উদাহরণ থাকে।

পদ্ধতি: batches.get

দীর্ঘস্থায়ী অপারেশনের সর্বশেষ অবস্থা পায়। ক্লায়েন্টরা API পরিষেবা দ্বারা সুপারিশকৃত বিরতিতে অপারেশন ফলাফল পোল করতে এই পদ্ধতি ব্যবহার করতে পারেন।

শেষবিন্দু

https: / /generativelanguage.googleapis.com /v1beta /{name=batches /*} পান

পাথ প্যারামিটার

name string

অপারেশন রিসোর্সের নাম। এটি ফর্ম batches/{batches} লাগে।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে Operation একটি উদাহরণ থাকে।

পদ্ধতি: batches.list

অনুরোধে নির্দিষ্ট ফিল্টারের সাথে মেলে এমন ক্রিয়াকলাপগুলিকে তালিকাভুক্ত করে৷ যদি সার্ভার এই পদ্ধতিটি সমর্থন না করে, তাহলে এটি UNIMPLEMENTED ফেরত দেয়।

শেষবিন্দু

https: / /generativelanguage.googleapis.com /v1beta /{name=batches} পান

পাথ প্যারামিটার

name string

অপারেশনের মূল সম্পদের নাম। এটা ফর্ম batches লাগে.

ক্যোয়ারী প্যারামিটার

filter string

স্ট্যান্ডার্ড তালিকা ফিল্টার।

pageSize integer

আদর্শ তালিকা পৃষ্ঠার আকার।

pageToken string

স্ট্যান্ডার্ড লিস্ট পেজ টোকেন।

returnPartialSuccess boolean

true সেট করা হলে, যে ক্রিয়াকলাপগুলি পৌঁছানো যায় সেগুলি স্বাভাবিক হিসাবে ফেরত দেওয়া হয় এবং যেগুলি পৌঁছানো যায় না সেগুলি [ListOperationsResponse.unreachable] ক্ষেত্রে ফেরত দেওয়া হয়।

এটি শুধুমাত্র তখনই true হতে পারে যখন সংগ্রহগুলি জুড়ে পড়ার সময় যেমন parent "projects/example/locations/-" এ সেট করা থাকে।

এই ক্ষেত্রটি ডিফল্টরূপে সমর্থিত নয় এবং পরিষেবা বা পণ্যের নির্দিষ্ট ডকুমেন্টেশনে অন্যথায় স্পষ্টভাবে নথিভুক্ত না হলে সেট করা হলে একটি UNIMPLEMENTED ত্রুটি দেখা দেবে।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে ListOperationsResponse এর একটি উদাহরণ থাকে।

পদ্ধতি: batches.cancel

একটি দীর্ঘ-চলমান অপারেশনে অ্যাসিঙ্ক্রোনাস বাতিলকরণ শুরু করে। সার্ভার অপারেশন বাতিল করার জন্য সর্বোত্তম প্রচেষ্টা করে, কিন্তু সাফল্য নিশ্চিত করা হয় না। সার্ভার এই পদ্ধতি সমর্থন না করলে, এটি google.rpc.Code.UNIMPLEMENTED প্রদান করে। বাতিলকরণ সফল হয়েছে কিনা বা বাতিল হওয়া সত্ত্বেও অপারেশন সম্পন্ন হয়েছে কিনা তা পরীক্ষা করতে গ্রাহকরা Operations.GetOperation বা অন্যান্য পদ্ধতি ব্যবহার করতে পারেন। সফল বাতিলকরণে, অপারেশনটি মুছে ফেলা হয় না; পরিবর্তে, এটি Code.CANCELLED এর সাথে সঙ্গতিপূর্ণ 1 এর google.rpc.Status.code সহ একটি Operation.error মান সহ একটি অপারেশন হয়ে যায়।

শেষবিন্দু

পোস্ট https: / /generativelanguage.googleapis.com /v1beta /{name=batches /*}:cancel

পাথ প্যারামিটার

name string

অপারেশন রিসোর্সের নাম বাতিল করা হবে। এটি ফর্ম batches/{batches} লাগে।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডি একটি খালি JSON অবজেক্ট।

পদ্ধতি: batches.delete

একটি দীর্ঘ-চলমান অপারেশন মুছে দেয়। এই পদ্ধতিটি নির্দেশ করে যে ক্লায়েন্ট আর অপারেশন ফলাফলে আগ্রহী নয়। এটি অপারেশন বাতিল করে না। সার্ভার এই পদ্ধতি সমর্থন না করলে, এটি google.rpc.Code.UNIMPLEMENTED প্রদান করে।

শেষবিন্দু

https: / /generativelanguage.googleapis.com /v1beta /{name=batches /*} মুছুন

পাথ প্যারামিটার

name string

অপারেশন রিসোর্সের নাম মুছে ফেলা হবে। এটি ফর্ম batches/{batches} লাগে।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডি একটি খালি JSON অবজেক্ট।

ContentBatch জেনারেট করুন

GenerateContent অনুরোধের একটি ব্যাচের প্রতিনিধিত্বকারী একটি সংস্থান।

ক্ষেত্র
model string

প্রয়োজন। সমাপ্তি তৈরি করার জন্য ব্যবহার করা Model নাম।

বিন্যাস: models/{model} ।

name string

শুধুমাত্র আউটপুট। শনাক্তকারী। ব্যাচের সম্পদের নাম।

বিন্যাস: batches/{batchId} ।

displayName string

প্রয়োজন। এই ব্যাচের ব্যবহারকারী-সংজ্ঞায়িত নাম।

inputConfig object ( InputConfig )

প্রয়োজন। ইনপুট কনফিগারেশন যেখানে ব্যাচ প্রক্রিয়াকরণ সঞ্চালিত হয়.

output object ( GenerateContentBatchOutput )

শুধুমাত্র আউটপুট। ব্যাচের অনুরোধের আউটপুট।

createTime string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে ব্যাচ তৈরি হয়েছিল।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

endTime string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে ব্যাচ প্রক্রিয়াকরণ সম্পন্ন হয়েছে।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

updateTime string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে ব্যাচ শেষ আপডেট করা হয়েছিল।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

batchStats object ( BatchStats )

শুধুমাত্র আউটপুট। ব্যাচ সম্পর্কে পরিসংখ্যান.

state enum ( BatchState )

শুধুমাত্র আউটপুট। ব্যাচের অবস্থা।

priority string ( int64 format)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। একটি উচ্চ অগ্রাধিকার মান সঙ্গে ব্যাচ একটি নিম্ন অগ্রাধিকার মান সঙ্গে ব্যাচ আগে প্রক্রিয়া করা হবে. নেতিবাচক মান অনুমোদিত. ডিফল্ট 0।

JSON প্রতিনিধিত্ব 
{
  "model": string,
  "name": string,
  "displayName": string,
  "inputConfig": {
    object (InputConfig)
  },
  "output": {
    object (GenerateContentBatchOutput)
  },
  "createTime": string,
  "endTime": string,
  "updateTime": string,
  "batchStats": {
    object (BatchStats)
  },
  "state": enum (BatchState),
  "priority": string
}

ইনপুট কনফিগারেশন

ব্যাচের অনুরোধে ইনপুট কনফিগার করে।

ক্ষেত্র
source Union type
প্রয়োজন। ইনপুট উৎস. source নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
fileName string

ইনপুট অনুরোধ ধারণকারী File নাম।

requests object ( InlinedRequests )

অনুরোধগুলি ব্যাচে প্রক্রিয়াকরণ করা হবে৷

JSON প্রতিনিধিত্ব 
{

  // source
  "fileName": string,
  "requests": {
    object (InlinedRequests)
  }
  // Union type
}

ইনলাইনড রিকোয়েস্ট

ব্যাচ তৈরির অনুরোধের অংশ হিসাবে প্রদান করা হলে ব্যাচে প্রক্রিয়া করা হবে।

ক্ষেত্র
requests[] object ( InlinedRequest )

প্রয়োজন। অনুরোধগুলি ব্যাচে প্রক্রিয়াকরণ করা হবে৷

JSON প্রতিনিধিত্ব 
{
  "requests": [
    {
      object (InlinedRequest)
    }
  ]
}

ইনলাইন্ড রিকোয়েস্ট

ব্যাচে প্রক্রিয়াকরণের অনুরোধ।

ক্ষেত্র
request object ( GenerateContentRequest )

প্রয়োজন। ব্যাচে প্রক্রিয়াকরণের অনুরোধ।

metadata object ( Struct format)

ঐচ্ছিক। অনুরোধের সাথে সংশ্লিষ্ট মেটাডেটা।

JSON প্রতিনিধিত্ব 
{
  "request": {
    object (GenerateContentRequest)
  },
  "metadata": {
    object
  }
}

ContentBatchOutput তৈরি করুন

একটি ব্যাচ অনুরোধের আউটপুট। এটি BatchGenerateContentResponse বা GenerateContentBatch.output ক্ষেত্রে ফেরত দেওয়া হয়।

ক্ষেত্র
output Union type
ব্যাচের অনুরোধের আউটপুট। output নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
responsesFile string

শুধুমাত্র আউটপুট। প্রতিক্রিয়া ধারণকারী ফাইলের ফাইল আইডি। ফাইলটি প্রতি লাইনে একটি একক প্রতিক্রিয়া সহ একটি JSONL ফাইল হবে। প্রতিক্রিয়াগুলি জেএসওএন হিসাবে ফর্ম্যাট করা GenerateContentResponse বার্তাগুলি হবে৷ প্রতিক্রিয়াগুলি ইনপুট অনুরোধগুলির মতো একই ক্রমে লেখা হবে৷

inlinedResponses object ( InlinedResponses )

শুধুমাত্র আউটপুট। ব্যাচে অনুরোধের প্রতিক্রিয়া. ইনলাইনযুক্ত অনুরোধগুলি ব্যবহার করে ব্যাচ তৈরি করা হলে ফিরে এসেছে। প্রতিক্রিয়াগুলি ইনপুট অনুরোধগুলির মতো একই ক্রমে হবে৷

JSON প্রতিনিধিত্ব 
{

  // output
  "responsesFile": string,
  "inlinedResponses": {
    object (InlinedResponses)
  }
  // Union type
}

ইনলাইনড রেসপন্স

ব্যাচে অনুরোধের প্রতিক্রিয়া.

ক্ষেত্র
inlinedResponses[] object ( InlinedResponse )

শুধুমাত্র আউটপুট। ব্যাচে অনুরোধের প্রতিক্রিয়া.

JSON প্রতিনিধিত্ব 
{
  "inlinedResponses": [
    {
      object (InlinedResponse)
    }
  ]
}

ইনলাইনড রেসপন্স

ব্যাচে একটি একক অনুরোধের প্রতিক্রিয়া।

ক্ষেত্র
metadata object ( Struct format)

শুধুমাত্র আউটপুট। অনুরোধের সাথে যুক্ত মেটাডেটা।

output Union type
অনুরোধের আউটপুট। output নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
error object ( Status )

শুধুমাত্র আউটপুট। অনুরোধটি প্রক্রিয়া করার সময় ত্রুটির সম্মুখীন হয়েছে৷

response object ( GenerateContentResponse )

শুধুমাত্র আউটপুট। অনুরোধের সাড়া।

JSON প্রতিনিধিত্ব 
{
  "metadata": {
    object
  },

  // output
  "error": {
    object (Status)
  },
  "response": {
    object (GenerateContentResponse)
  }
  // Union type
}

ব্যাচ পরিসংখ্যান

ব্যাচ সম্পর্কে পরিসংখ্যান.

ক্ষেত্র
requestCount string ( int64 format)

শুধুমাত্র আউটপুট। ব্যাচে অনুরোধের সংখ্যা।

successfulRequestCount string ( int64 format)

শুধুমাত্র আউটপুট। সফলভাবে প্রসেস করা অনুরোধের সংখ্যা।

failedRequestCount string ( int64 format)

শুধুমাত্র আউটপুট। প্রসেস করা যায়নি এমন অনুরোধের সংখ্যা।

pendingRequestCount string ( int64 format)

শুধুমাত্র আউটপুট। এখনও প্রসেসিং বাকি আছে যে অনুরোধের সংখ্যা.

JSON প্রতিনিধিত্ব 
{
  "requestCount": string,
  "successfulRequestCount": string,
  "failedRequestCount": string,
  "pendingRequestCount": string
}

পদ্ধতি: batches.updateEmbedContentBatch

ব্যাচ প্রক্রিয়াকরণের জন্য EmbedContent অনুরোধের একটি ব্যাচ আপডেট করে।

শেষবিন্দু

প্যাচ https: / /generativelanguage.googleapis.com /v1beta /{embedContentBatch.name=batches /*}:updateEmbedContentBatch
PATCH https://generativelanguage.googleapis.com/v1beta/{embedContentBatch.name=batches/*}:updateEmbedContentBatch

পাথ প্যারামিটার

embedContentBatch.name string

শুধুমাত্র আউটপুট। শনাক্তকারী। ব্যাচের সম্পদের নাম।

বিন্যাস: batches/{batchId} । এটি ফর্ম batches/{batches} লাগে।

ক্যোয়ারী প্যারামিটার

updateMask string ( FieldMask format)

ঐচ্ছিক। আপডেট করার জন্য ক্ষেত্রগুলির তালিকা৷

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo" ।

শরীরের অনুরোধ

অনুরোধের অংশে EmbedContentBatch এর একটি উদাহরণ রয়েছে।

ক্ষেত্র
model string

প্রয়োজন। সমাপ্তি তৈরি করার জন্য ব্যবহার করা Model নাম।

বিন্যাস: models/{model} ।

displayName string

প্রয়োজন। এই ব্যাচের ব্যবহারকারী-সংজ্ঞায়িত নাম।

inputConfig object ( InputEmbedContentConfig )

প্রয়োজন। ইনপুট কনফিগারেশন যেখানে ব্যাচ প্রক্রিয়াকরণ সঞ্চালিত হয়.

priority string ( int64 format)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। একটি উচ্চ অগ্রাধিকার মান সঙ্গে ব্যাচ একটি নিম্ন অগ্রাধিকার মান সঙ্গে ব্যাচ আগে প্রক্রিয়া করা হবে. নেতিবাচক মান অনুমোদিত. ডিফল্ট 0।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে EmbedContentBatch এর একটি উদাহরণ থাকে।

EmbedContentRequest

মডেলটি এম্বেড করার জন্য Content সহ অনুরোধ৷

ক্ষেত্র
model string

প্রয়োজন। মডেলের সম্পদের নাম। এটি মডেল ব্যবহার করার জন্য একটি আইডি হিসাবে কাজ করে।

এই নামটি ListModels পদ্ধতি দ্বারা প্রত্যাবর্তিত একটি মডেল নামের সাথে মেলে।

বিন্যাস: models/{model}

content object ( Content )

প্রয়োজন। এম্বেড করার বিষয়বস্তু। শুধুমাত্র parts.text ক্ষেত্র গণনা করা হবে।

taskType enum ( TaskType )

ঐচ্ছিক। ঐচ্ছিক টাস্ক টাইপ যার জন্য এম্বেডিং ব্যবহার করা হবে। আগের মডেলগুলিতে সমর্থিত নয় ( models/embedding-001 )।

title string

ঐচ্ছিক। পাঠ্যের জন্য একটি ঐচ্ছিক শিরোনাম। শুধুমাত্র টাস্কটাইপ RETRIEVAL_DOCUMENT হলেই প্রযোজ্য।

দ্রষ্টব্য: RETRIEVAL_DOCUMENT এর জন্য একটি title নির্দিষ্ট করা পুনরুদ্ধারের জন্য আরও ভাল মানের এম্বেডিং প্রদান করে৷

outputDimensionality integer

ঐচ্ছিক। আউটপুট এম্বেডিংয়ের জন্য ঐচ্ছিক হ্রাস মাত্রা। যদি সেট করা থাকে, আউটপুট এম্বেডিংয়ের অতিরিক্ত মান শেষ থেকে কেটে ফেলা হয়। শুধুমাত্র 2024 সাল থেকে নতুন মডেল দ্বারা সমর্থিত। পূর্ববর্তী মডেল ব্যবহার করলে আপনি এই মান সেট করতে পারবেন না ( models/embedding-001 )।

JSON প্রতিনিধিত্ব 
{
  "model": string,
  "content": {
    object (Content)
  },
  "taskType": enum (TaskType),
  "title": string,
  "outputDimensionality": integer
}

পদ্ধতি: batches.updateGenerateContentBatch

ব্যাচ প্রক্রিয়াকরণের জন্য GenerateContent অনুরোধের একটি ব্যাচ আপডেট করে।

শেষবিন্দু

প্যাচ https: / /generativelanguage.googleapis.com /v1beta /{generateContentBatch.name=batches /*}:updateGenerateContentBatch
PATCH https://generativelanguage.googleapis.com/v1beta/{generateContentBatch.name=batches/*}:updateGenerateContentBatch

পাথ প্যারামিটার

generateContentBatch.name string

শুধুমাত্র আউটপুট। শনাক্তকারী। ব্যাচের সম্পদের নাম।

বিন্যাস: batches/{batchId} । এটি ফর্ম batches/{batches} লাগে।

ক্যোয়ারী প্যারামিটার

updateMask string ( FieldMask format)

ঐচ্ছিক। আপডেট করার জন্য ক্ষেত্রগুলির তালিকা৷

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo" ।

শরীরের অনুরোধ

অনুরোধের অংশে GenerateContentBatch এর একটি উদাহরণ রয়েছে।

ক্ষেত্র
model string

প্রয়োজন। সমাপ্তি তৈরি করার জন্য ব্যবহার করা Model নাম।

বিন্যাস: models/{model} ।

displayName string

প্রয়োজন। এই ব্যাচের ব্যবহারকারী-সংজ্ঞায়িত নাম।

inputConfig object ( InputConfig )

প্রয়োজন। ইনপুট কনফিগারেশন যেখানে ব্যাচ প্রক্রিয়াকরণ সঞ্চালিত হয়.

priority string ( int64 format)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। একটি উচ্চ অগ্রাধিকার মান সঙ্গে ব্যাচ একটি নিম্ন অগ্রাধিকার মান সঙ্গে ব্যাচ আগে প্রক্রিয়া করা হবে. নেতিবাচক মান অনুমোদিত. ডিফল্ট 0।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে GenerateContentBatch এর একটি উদাহরণ থাকে।

কন্টেন্ট রিকোয়েস্ট জেনারেট করুন

মডেল থেকে একটি সম্পূর্ণতা তৈরি করার জন্য অনুরোধ করুন. পরবর্তী আইডি: 18

ক্ষেত্র
model string

প্রয়োজন। সমাপ্তি তৈরি করার জন্য ব্যবহার করা Model নাম।

বিন্যাস: models/{model} ।

contents[] object ( Content )

প্রয়োজন। মডেলের সাথে বর্তমান কথোপকথনের বিষয়বস্তু।

একক-পালা প্রশ্নের জন্য, এটি একটি একক উদাহরণ। চ্যাটের মতো বহু-মুখী প্রশ্নের জন্য, এটি একটি পুনরাবৃত্ত ক্ষেত্র যাতে কথোপকথনের ইতিহাস এবং সর্বশেষ অনুরোধ থাকে।

tools[] object ( Tool )

ঐচ্ছিক। পরবর্তী প্রতিক্রিয়া তৈরি করতে Model ব্যবহার করতে পারে Tools একটি তালিকা৷

একটি Tool হল কোডের একটি অংশ যা Model জ্ঞান এবং সুযোগের বাইরে একটি ক্রিয়া সম্পাদন করতে বা ক্রিয়াগুলির সেট করার জন্য সিস্টেমকে বহিরাগত সিস্টেমের সাথে যোগাযোগ করতে সক্ষম করে। সমর্থিত Tool হল Function এবং codeExecution । আরও জানতে ফাংশন কলিং এবং কোড এক্সিকিউশন গাইডগুলি পড়ুন।

toolConfig object ( ToolConfig )

ঐচ্ছিক। অনুরোধে উল্লেখ করা যেকোনো Tool জন্য টুল কনফিগারেশন। একটি ব্যবহারের উদাহরণের জন্য ফাংশন কলিং গাইড পড়ুন।

safetySettings[] object ( SafetySetting )

ঐচ্ছিক। অনিরাপদ বিষয়বস্তু ব্লক করার জন্য অনন্য SafetySetting দৃষ্টান্তের একটি তালিকা।

এটি GenerateContentRequest.contents এবং GenerateContentResponse.candidates এ প্রয়োগ করা হবে। প্রতিটি SafetyCategory প্রকারের জন্য একাধিক সেটিং থাকা উচিত নয়৷ এপিআই এই সেটিংস দ্বারা নির্ধারিত থ্রেশহোল্ড পূরণ করতে ব্যর্থ যে কোনো বিষয়বস্তু এবং প্রতিক্রিয়া ব্লক করবে। এই তালিকাটি সেফটিসেটিংসে নির্দিষ্ট করা প্রতিটি SafetyCategory জন্য ডিফল্ট সেটিংস ওভাররাইড করে। যদি তালিকায় প্রদত্ত একটি প্রদত্ত SafetyCategory জন্য কোনো SafetySetting না থাকে, তাহলে API সেই বিভাগের জন্য ডিফল্ট নিরাপত্তা সেটিং ব্যবহার করবে। ক্ষতির বিভাগগুলি HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT, HARM_CATEGORY_CIVIC_INTEGRITY সমর্থিত৷ উপলব্ধ নিরাপত্তা সেটিংস সম্পর্কে বিস্তারিত তথ্যের জন্য গাইড পড়ুন। এছাড়াও আপনার AI অ্যাপ্লিকেশনগুলিতে সুরক্ষা বিবেচনাগুলি কীভাবে অন্তর্ভুক্ত করবেন তা শিখতে সুরক্ষা নির্দেশিকা পড়ুন।

systemInstruction object ( Content )

ঐচ্ছিক। বিকাশকারী সেট সিস্টেম নির্দেশনা(গুলি) । বর্তমানে, শুধুমাত্র টেক্সট.

generationConfig object ( GenerationConfig )

ঐচ্ছিক। মডেল জেনারেশন এবং আউটপুটগুলির জন্য কনফিগারেশন বিকল্প।

cachedContent string

ঐচ্ছিক। ভবিষ্যদ্বাণী পরিবেশনের জন্য প্রসঙ্গ হিসাবে ব্যবহার করার জন্য ক্যাশ করা সামগ্রীর নাম৷ বিন্যাস: cachedContents/{cachedContent}

JSON প্রতিনিধিত্ব 
{
  "model": string,
  "contents": [
    {
      object (Content)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "toolConfig": {
    object (ToolConfig)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "systemInstruction": {
    object (Content)
  },
  "generationConfig": {
    object (GenerationConfig)
  },
  "cachedContent": string
}

ব্যাচস্টেট

ব্যাচের অবস্থা।

Enums
BATCH_STATE_UNSPECIFIED ব্যাচের অবস্থা অনির্দিষ্ট।
BATCH_STATE_PENDING সেবার ব্যাচ চালানোর প্রস্তুতি নিচ্ছে।
BATCH_STATE_RUNNING ব্যাচ চলছে।
BATCH_STATE_SUCCEEDED ব্যাচ সফলভাবে সম্পন্ন হয়েছে.
BATCH_STATE_FAILED ব্যাচ ব্যর্থ হয়েছে।
BATCH_STATE_CANCELLED ব্যাচ বাতিল করা হয়েছে।
BATCH_STATE_EXPIRED ব্যাচের মেয়াদ শেষ হয়ে গেছে।

REST সম্পদ: ব্যাচ

সম্পদ: অপারেশন

এই সংস্থানটি একটি দীর্ঘ-চলমান ক্রিয়াকলাপের প্রতিনিধিত্ব করে যা একটি নেটওয়ার্ক API কলের ফলাফল।

ক্ষেত্র
name string

সার্ভার দ্বারা নির্ধারিত নাম, যা শুধুমাত্র একই পরিষেবার মধ্যে অনন্য যা মূলত এটিকে ফেরত দেয়। আপনি যদি ডিফল্ট HTTP ম্যাপিং ব্যবহার করেন, name operations/{unique_id} দিয়ে শেষ হওয়া একটি সংস্থান নাম হওয়া উচিত।

metadata object

অপারেশনের সাথে সম্পর্কিত পরিষেবা-নির্দিষ্ট মেটাডেটা। এটিতে সাধারণত অগ্রগতি তথ্য এবং সাধারণ মেটাডেটা থাকে যেমন সময় তৈরি করা। কিছু পরিষেবা এই ধরনের মেটাডেটা প্রদান নাও করতে পারে। যে কোনও পদ্ধতি যা একটি দীর্ঘ-চলমান ক্রিয়াকলাপ ফেরত দেয় তার মেটাডেটা প্রকার নথিভুক্ত করা উচিত, যদি থাকে।

একটি নির্বিচারী ধরনের ক্ষেত্র ধারণকারী একটি বস্তু. একটি অতিরিক্ত ক্ষেত্র "@type" এ টাইপ সনাক্তকারী একটি URI রয়েছে৷ উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।

done boolean

যদি মানটি false হয়, তাহলে এর অর্থ অপারেশন এখনও চলছে। true হলে, অপারেশন সম্পন্ন হয়, এবং হয় error বা response পাওয়া যায়।

result Union type
অপারেশন ফলাফল, যা একটি error বা একটি বৈধ response হতে পারে। যদি done == false , কোন error বা response সেট করা হয় না। যদি done == true , ঠিক একটি error বা response সেট করা যেতে পারে। কিছু পরিষেবা ফলাফল নাও দিতে পারে। result শুধুমাত্র নিম্নলিখিত একটি হতে পারে:
error object ( Status )

ব্যর্থতা বা বাতিলের ক্ষেত্রে অপারেশনের ত্রুটির ফলাফল।

response object

অপারেশনের স্বাভাবিক, সফল প্রতিক্রিয়া। যদি মূল পদ্ধতিটি সফলতার কোনো ডেটা না দেয়, যেমন Delete , তাহলে প্রতিক্রিয়া হল google.protobuf.Empty । যদি মূল পদ্ধতিটি মানক হয় Get / Create / Update , তাহলে রিসোর্স রিসোর্স হওয়া উচিত। অন্যান্য পদ্ধতির জন্য, প্রতিক্রিয়াটিতে XxxResponse টাইপ হওয়া উচিত, যেখানে Xxx হল মূল পদ্ধতির নাম। উদাহরণস্বরূপ, যদি মূল পদ্ধতির নাম হয় TakeSnapshot() , তাহলে অনুমিত প্রতিক্রিয়ার ধরনটি হল TakeSnapshotResponse ।

একটি নির্বিচারী ধরনের ক্ষেত্র ধারণকারী একটি বস্তু. একটি অতিরিক্ত ক্ষেত্র "@type" এ টাইপ সনাক্তকারী একটি URI রয়েছে৷ উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।

JSON প্রতিনিধিত্ব 
{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // result
  "error": {
    object (Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // Union type
}