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)

ঐচ্ছিক। ব্যাচের অগ্রাধিকার। উচ্চতর অগ্রাধিকার মান সম্পন্ন ব্যাচগুলি কম অগ্রাধিকার মান সম্পন্ন ব্যাচের আগে প্রক্রিয়া করা হবে। নেতিবাচক মান অনুমোদিত। ডিফল্ট মান 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 পান https: / /generativelanguage.googleapis.com /v1beta /{name=batches /*}

পথের পরামিতি

name string

অপারেশন রিসোর্সের নাম। এটি batches/{batches} আকারে আসে।

অনুরোধের মূল অংশ

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

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

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

পদ্ধতি: batches.list

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

শেষবিন্দু

https পান 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 বা অন্যান্য পদ্ধতি ব্যবহার করে বাতিলকরণ সফল হয়েছে কিনা বা বাতিলকরণ সত্ত্বেও অপারেশনটি সম্পন্ন হয়েছে কিনা তা পরীক্ষা করতে পারে। সফল বাতিলকরণের পরে, অপারেশনটি মুছে ফেলা হয় না; পরিবর্তে, এটি একটি অপারেশনে পরিণত হয় যার Operation.error মান 1 থাকে যার google.rpc.Status.code 1 থাকে, যা Code.CANCELLED এর সাথে সম্পর্কিত।

শেষবিন্দু

পোস্ট 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 /*} মুছে ফেলুন : / /generativelanguage.googleapis.com /v1beta /{name=batches /*}

পথের পরামিতি

name string

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

অনুরোধের মূল অংশ

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

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

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

জেনারেটকন্টেন্টব্যাচ

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

জেনারেটকন্টেন্টব্যাচআউটপুট

একটি ব্যাচ অনুরোধের আউটপুট। এটি 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
request. 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 এর একটি উদাহরণ থাকবে।

এম্বেডকন্টেন্টরিকোয়েস্ট

মডেলটি এম্বেড করার জন্য 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

ঐচ্ছিক। আউটপুট এম্বেডিংয়ের জন্য ঐচ্ছিক হ্রাসকৃত মাত্রা। যদি সেট করা থাকে, তাহলে আউটপুট এম্বেডিংয়ের অতিরিক্ত মানগুলি শেষ থেকে কেটে ফেলা হবে। 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 এর একটি ইনস্ট্যান্স থাকবে।

কন্টেন্টরিকোয়েস্ট তৈরি করুন

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

ক্ষেত্র
model string

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

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

contents[] object ( Content )

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

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

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 সমর্থিত। উপলব্ধ নিরাপত্তা সেটিংস সম্পর্কে বিস্তারিত তথ্যের জন্য নির্দেশিকাটি পড়ুন। আপনার 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
}

ব্যাচস্টেট

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

এনামস
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" } ।

boolean done

যদি মানটি 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
}