Method: models.generateText

একটি ইনপুট বার্তা দেওয়া মডেল থেকে একটি প্রতিক্রিয়া তৈরি করে।

HTTP অনুরোধ

POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateText

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

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

পরামিতি
model

string

প্রয়োজন। Model বা TunedModel এর নাম যা সম্পূর্ণতা তৈরি করার জন্য ব্যবহার করা হবে। উদাহরণ: models/text-bison-001 tunedModels/sentence-translator-u3b7m

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

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

JSON প্রতিনিধিত্ব
{
  "prompt": {
    object (TextPrompt)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "stopSequences": [
    string
  ],
  "temperature": number,
  "candidateCount": integer,
  "maxOutputTokens": integer,
  "topP": number,
  "topK": integer
}
ক্ষেত্র
prompt

object ( TextPrompt )

প্রয়োজন। প্রম্পট হিসাবে মডেলকে দেওয়া ফ্রি-ফর্ম ইনপুট পাঠ্য।

একটি প্রম্পট দেওয়া হলে, মডেলটি একটি TextCompletion প্রতিক্রিয়া তৈরি করবে যা এটি ইনপুট পাঠ্যের সমাপ্তির পূর্বাভাস দেয়।

safetySettings[]

object ( SafetySetting )

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

যা GenerateTextRequest.prompt এবং GenerateTextResponse.candidates এ প্রয়োগ করা হবে। প্রতিটি SafetyCategory প্রকারের জন্য একাধিক সেটিং থাকা উচিত নয়৷ এপিআই এই সেটিংস দ্বারা নির্ধারিত থ্রেশহোল্ড পূরণ করতে ব্যর্থ যে কোনো প্রম্পট এবং প্রতিক্রিয়া ব্লক করবে। এই তালিকাটি সেফটিসেটিংসে নির্দিষ্ট করা প্রতিটি SafetyCategory জন্য ডিফল্ট সেটিংস ওভাররাইড করে। যদি তালিকায় প্রদত্ত একটি প্রদত্ত SafetyCategory জন্য কোনো SafetySetting না থাকে, তাহলে API সেই বিভাগের জন্য ডিফল্ট নিরাপত্তা সেটিং ব্যবহার করবে। ক্ষতির বিভাগ HARM_CATEGORY_DEROGATORY, HARM_CATEGORY_TOXICITY, HARM_CATEGORY_VIOLENCE, HARM_CATEGORY_SEXUAL, HARM_CATEGORY_MEDICAL, HARM_CATEGORY_DANGEROUS পাঠ্য পরিষেবাতে সমর্থিত।

stopSequences[]

string

ক্যারেক্টার সিকোয়েন্সের সেট (5 পর্যন্ত) যা আউটপুট জেনারেশন বন্ধ করবে। নির্দিষ্ট করা হলে, API একটি স্টপ সিকোয়েন্সের প্রথম উপস্থিতিতে থামবে। স্টপ ক্রম প্রতিক্রিয়া অংশ হিসাবে অন্তর্ভুক্ত করা হবে না.

temperature

number

ঐচ্ছিক। আউটপুটের এলোমেলোতা নিয়ন্ত্রণ করে। দ্রষ্টব্য: ডিফল্ট মান মডেল অনুসারে পরিবর্তিত হয়, দেখুন Model Model.temperature বৈশিষ্ট্যটি getModel ফাংশন প্রদান করেছে।

মানগুলি সহ [0.0,1.0] থেকে পরিসীমা হতে পারে। 1.0-এর কাছাকাছি একটি মান প্রতিক্রিয়া তৈরি করবে যা আরও বৈচিত্র্যময় এবং সৃজনশীল, যখন 0.0-এর কাছাকাছি একটি মান সাধারণত মডেল থেকে আরও সহজবোধ্য প্রতিক্রিয়া তৈরি করবে।

candidateCount

integer

ঐচ্ছিক। ফিরে আসার জন্য উত্পন্ন প্রতিক্রিয়ার সংখ্যা।

এই মানটি অবশ্যই [1, 8] এর মধ্যে হতে হবে। সেট না থাকলে, এটি 1 এ ডিফল্ট হবে।

maxOutputTokens

integer

ঐচ্ছিক। একজন প্রার্থীকে অন্তর্ভুক্ত করার জন্য সর্বাধিক সংখ্যক টোকেন।

সেট না থাকলে, এটি Model স্পেসিফিকেশনে নির্দিষ্ট করা আউটপুট টোকেন লিমিটে ডিফল্ট হবে।

topP

number

ঐচ্ছিক। নমুনা নেওয়ার সময় বিবেচনা করতে টোকেনগুলির সর্বাধিক ক্রমবর্ধমান সম্ভাবনা৷

মডেলটি সম্মিলিত টপ-কে এবং নিউক্লিয়াস স্যাম্পলিং ব্যবহার করে।

টোকেনগুলি তাদের নির্ধারিত সম্ভাব্যতার উপর ভিত্তি করে সাজানো হয় যাতে শুধুমাত্র সবচেয়ে সম্ভাব্য টোকেনগুলিকে বিবেচনা করা হয়। টপ-কে নমুনা সরাসরি বিবেচনা করার জন্য সর্বাধিক সংখ্যক টোকেনকে সীমাবদ্ধ করে, যখন নিউক্লিয়াস স্যাম্পলিং ক্রমবর্ধমান সম্ভাব্যতার উপর ভিত্তি করে টোকেনের সংখ্যা সীমাবদ্ধ করে।

দ্রষ্টব্য: ডিফল্ট মান মডেল অনুসারে পরিবর্তিত হয়, দেখুন Model Model.top_p বৈশিষ্ট্যটি getModel ফাংশন প্রদান করেছে।

topK

integer

ঐচ্ছিক। নমুনা নেওয়ার সময় সর্বাধিক সংখ্যক টোকেন বিবেচনা করতে হবে।

মডেলটি সম্মিলিত টপ-কে এবং নিউক্লিয়াস স্যাম্পলিং ব্যবহার করে।

Top-k স্যাম্পলিং topK সবচেয়ে সম্ভাব্য টোকেনের সেট বিবেচনা করে। ডিফল্ট 40.

দ্রষ্টব্য: ডিফল্ট মান মডেল অনুসারে পরিবর্তিত হয়, দেখুন Model Model.top_k বৈশিষ্ট্যটি getModel ফাংশন প্রদান করেছে।

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

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

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

আরও তথ্যের জন্য, প্রমাণীকরণ ওভারভিউ দেখুন।