Batch 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)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। উচ্চতর অগ্রাধিকার মানযুক্ত ব্যাচগুলি নিম্নতর অগ্রাধিকার মানযুক্ত ব্যাচগুলির আগে প্রক্রিয়াজাত করা হবে। ঋণাত্মক মান অনুমোদিত। ডিফল্ট হলো ০।

প্রতিক্রিয়া মূল অংশ

যদি সফল হয়, তাহলে রেসপন্স বডিতে 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)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। উচ্চতর অগ্রাধিকার মানযুক্ত ব্যাচগুলি নিম্নতর অগ্রাধিকার মানযুক্ত ব্যাচগুলির আগে প্রক্রিয়াজাত করা হবে। ঋণাত্মক মান অনুমোদিত। ডিফল্ট হলো ০।

প্রতিক্রিয়া মূল অংশ

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

পদ্ধতি: ব্যাচ.গেট

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

এন্ডপয়েন্ট

get https: / /generativelanguage.googleapis.com /v1beta /{name=batches /*}

পথের পরামিতি

name string

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

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া মূল অংশ

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

পদ্ধতি: ব্যাচ.তালিকা

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

এন্ডপয়েন্ট

get 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 এর একটি ইনস্ট্যান্স থাকে।

পদ্ধতি: ব্যাচ বাতিল করুন

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

এন্ডপয়েন্ট

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

পথের পরামিতি

name string

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

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া মূল অংশ

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

পদ্ধতি: ব্যাচগুলি মুছে ফেলুন

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

এন্ডপয়েন্ট

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

পথের পরামিতি

name string

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

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া মূল অংশ

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

GenerateContentBatch

একটি রিসোর্স যা একগুচ্ছ 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)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। উচ্চতর অগ্রাধিকার মানযুক্ত ব্যাচগুলি নিম্নতর অগ্রাধিকার মানযুক্ত ব্যাচগুলির আগে প্রক্রিয়াজাত করা হবে। ঋণাত্মক মান অনুমোদিত। ডিফল্ট হলো ০।

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
  }
}

GenerateContentBatchOutput

ব্যাচ অনুরোধের আউটপুট। এটি BatchGenerateContentResponse অথবা GenerateContentBatch.output ফিল্ডে ফেরত আসে।

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

শুধুমাত্র আউটপুট। প্রতিক্রিয়াগুলো ধারণকারী ফাইলের ফাইল আইডি। ফাইলটি একটি JSONL ফাইল হবে যেখানে প্রতি লাইনে একটি করে প্রতিক্রিয়া থাকবে। প্রতিক্রিয়াগুলো JSON ফরম্যাটে 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 অনুরোধ আপডেট করে।

এন্ডপয়েন্ট

patch 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)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। উচ্চতর অগ্রাধিকার মানযুক্ত ব্যাচগুলি নিম্নতর অগ্রাধিকার মানযুক্ত ব্যাচগুলির আগে প্রক্রিয়াজাত করা হবে। ঋণাত্মক মান অনুমোদিত। ডিফল্ট হলো ০।

প্রতিক্রিয়া মূল অংশ

সফল হলে, রেসপন্স বডিতে EmbedContentBatch এর একটি ইনস্ট্যান্স থাকে।

এমবেড কন্টেন্ট অনুরোধ

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

ক্ষেত্র
model string

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

এই নামটি ListModels মেথড দ্বারা ফেরত আসা মডেল নামের সাথে মিলতে হবে।

ফরম্যাট: models/{model}

content object ( Content )

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

taskType enum ( TaskType )

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

title string

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

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

outputDimensionality integer

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

JSON উপস্থাপনা 
{
  "model": string,
  "content": {
    object (Content)
  },
  "taskType": enum (TaskType),
  "title": string,
  "outputDimensionality": integer
}

পদ্ধতি: batches.updateGenerateContentBatch

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

এন্ডপয়েন্ট

patch 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)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। উচ্চতর অগ্রাধিকার মানযুক্ত ব্যাচগুলি নিম্নতর অগ্রাধিকার মানযুক্ত ব্যাচগুলির আগে প্রক্রিয়াজাত করা হবে। ঋণাত্মক মান অনুমোদিত। ডিফল্ট হলো ০।

প্রতিক্রিয়া মূল অংশ

সফল হলে, রেসপন্স বডিতে GenerateContentBatch এর একটি ইনস্ট্যান্স থাকে।

বিষয়বস্তু তৈরি করার অনুরোধ

মডেল থেকে একটি সমাপ্তি তৈরি করার অনুরোধ।

ক্ষেত্র
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 প্রকারের জন্য একাধিক সেটিং থাকা উচিত নয়। এই সেটিং দ্বারা নির্ধারিত থ্রেশহোল্ড পূরণ করতে ব্যর্থ যেকোনো কন্টেন্ট এবং রেসপন্স API ব্লক করে দেবে। এই তালিকাটি safetySettings-এ নির্দিষ্ট করা প্রতিটি SafetyCategory জন্য ডিফল্ট সেটিংগুলোকে ওভাররাইড করে। যদি তালিকায় প্রদত্ত কোনো নির্দিষ্ট SafetyCategory জন্য SafetySetting না থাকে, তাহলে API সেই ক্যাটাগরির জন্য ডিফল্ট সেফটি সেটিং ব্যবহার করবে। HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT, HARM_CATEGORY_CIVIC_INTEGRITY এই Harm ক্যাটাগরিগুলো সমর্থিত। উপলব্ধ সেফটি সেটিংস সম্পর্কে বিস্তারিত তথ্যের জন্য গাইডটি দেখুন। এছাড়াও, আপনার AI অ্যাপ্লিকেশনগুলিতে কীভাবে সুরক্ষার বিষয়গুলো অন্তর্ভুক্ত করবেন তা জানতে সেফটি গাইডেন্স দেখুন।

systemInstruction object ( Content )

ঐচ্ছিক। ডেভেলপার কর্তৃক নির্ধারিত সিস্টেম নির্দেশাবলী । বর্তমানে, শুধুমাত্র টেক্সট আকারে উপলব্ধ।

generationConfig object ( GenerationConfig )

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

cachedContent string

ঐচ্ছিক। প্রেডিকশন পরিবেশনের জন্য কনটেক্সট হিসেবে ব্যবহার করার জন্য ক্যাশ করা কন্টেন্টের নাম। ফরম্যাট: cachedContents/{cachedContent}

boolean store

ঐচ্ছিক। এটি একটি নির্দিষ্ট অনুরোধের জন্য লগিং আচরণ নির্ধারণ করে। সেট করা হলে, এটি প্রজেক্ট-স্তরের লগিং কনফিগারেশনের চেয়ে অগ্রাধিকার পায়।

JSON উপস্থাপনা 
{
  "model": string,
  "contents": [
    {
      object (Content)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "toolConfig": {
    object (ToolConfig)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "systemInstruction": {
    object (Content)
  },
  "generationConfig": {
    object (GenerationConfig)
  },
  "cachedContent": string,
  "store": boolean
}

ব্যাচস্টেট

ব্যাচটির অবস্থা।

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

REST রিসোর্স: ব্যাচ

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

এই রিসোর্সটি একটি দীর্ঘস্থায়ী অপারেশনকে নির্দেশ করে, যা একটি নেটওয়ার্ক এপিআই কলের ফলাফল।

ক্ষেত্র
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
}