- نمایندگی JSON
- نامزد
- FinishReason
- رتبه ایمنی
- احتمال آسیب
- CitationMetadata
- منبع استناد
- PromptFeedback
- BlockReason
پاسخ از مدلی که از چندین نامزد پشتیبانی می کند.
توجه به رتبه بندی ایمنی و فیلتر محتوا. آنها هم برای prompt در GenerateContentResponse.prompt_feedback
و هم برای هر کاندید در finishReason
و در safetyRatings
گزارش می شوند. قرارداد API به این صورت است که: - یا همه کاندیداهای درخواست شده برگردانده می شوند یا اصلاً هیچ نامزدی وجود ندارد - هیچ نامزدی فقط در صورتی بازگردانده نمی شود که مشکلی در دستور وجود داشته باشد (به promptFeedback
مراجعه کنید) - بازخورد هر نامزد در finishReason
و safetyRatings
گزارش می شود.
نمایندگی JSON |
---|
{ "candidates": [ { object ( |
زمینه های | |
---|---|
candidates[] | پاسخ های کاندیدا از مدل. |
promptFeedback | بازخورد درخواست مربوط به فیلترهای محتوا را برمیگرداند. |
نامزد
یک کاندید پاسخ تولید شده از مدل.
نمایندگی JSON |
---|
{ "content": { object ( |
زمینه های | |
---|---|
content | فقط خروجی محتوای تولید شده از مدل برگردانده شده است. |
finishReason | اختیاری. فقط خروجی دلیل توقف تولید توکن توسط مدل. اگر خالی باشد، مدل تولید توکن ها را متوقف نکرده است. |
safetyRatings[] | فهرست رتبه بندی برای ایمنی یک نامزد پاسخ. حداکثر یک رتبه برای هر دسته وجود دارد. |
citationMetadata | فقط خروجی اطلاعات استناد برای نامزد تولید شده توسط مدل. این قسمت ممکن است با اطلاعات تلاوت برای هر متن موجود در |
tokenCount | فقط خروجی شمارش رمز برای این نامزد. |
index | فقط خروجی فهرست نامزد در فهرست نامزدها. |
FinishReason
دلیل توقف تولید توکن ها توسط مدل را مشخص می کند.
Enums | |
---|---|
FINISH_REASON_UNSPECIFIED | مقدار پیش فرض. این مقدار استفاده نشده است. |
STOP | نقطه توقف طبیعی مدل یا توالی توقف ارائه شده. |
MAX_TOKENS | حداکثر تعداد توکنهایی که در درخواست مشخص شده بود به دست آمد. |
SAFETY | محتوای نامزد به دلایل ایمنی پرچم گذاری شد. |
RECITATION | محتوای نامزد به دلایل تلاوت علامت گذاری شد. |
OTHER | دلیل نامعلوم. |
رتبه ایمنی
رتبه بندی ایمنی برای یک قطعه محتوا.
رتبه بندی ایمنی شامل دسته آسیب و سطح احتمال آسیب در آن دسته برای یک قطعه محتوا است. محتوا برای ایمنی در تعدادی از دستههای آسیب طبقهبندی شده است و احتمال طبقهبندی آسیب در اینجا گنجانده شده است.
نمایندگی JSON |
---|
{ "category": enum ( |
زمینه های | |
---|---|
category | ضروری. دسته بندی برای این رتبه بندی |
probability | ضروری. احتمال آسیب برای این محتوا. |
blocked | آیا این محتوا به دلیل این رتبه بندی مسدود شده است؟ |
احتمال آسیب
احتمال مضر بودن یک قطعه محتوا.
سیستم طبقه بندی احتمال ناامن بودن محتوا را می دهد. این نشان دهنده شدت آسیب برای یک قطعه محتوا نیست.
Enums | |
---|---|
HARM_PROBABILITY_UNSPECIFIED | احتمال نامشخص است. |
NEGLIGIBLE | احتمال ناامن بودن محتوا ناچیز است. |
LOW | احتمال ناامن بودن محتوا کم است. |
MEDIUM | محتوا شانس متوسطی برای ناایمن بودن دارد. |
HIGH | محتوا شانس بالایی برای ناامن بودن دارد. |
CitationMetadata
مجموعه ای از منابع منبع برای یک قطعه محتوا.
نمایندگی JSON |
---|
{
"citationSources": [
{
object ( |
زمینه های | |
---|---|
citationSources[] | استناد به منابع برای پاسخ خاص. |
منبع استناد
استناد به یک منبع برای بخشی از یک پاسخ خاص.
نمایندگی JSON |
---|
{ "startIndex": integer, "endIndex": integer, "uri": string, "license": string } |
زمینه های | |
---|---|
startIndex | اختیاری. شروع بخش پاسخی که به این منبع نسبت داده می شود. شاخص شروع بخش را نشان می دهد که در بایت اندازه گیری می شود. |
endIndex | اختیاری. انتهای بخش منتسب، انحصاری. |
uri | اختیاری. URI که به عنوان منبع بخشی از متن نسبت داده می شود. |
license | اختیاری. مجوز برای پروژه GitHub که به عنوان منبعی برای بخش نسبت داده می شود. اطلاعات مجوز برای استناد کد مورد نیاز است. |
PromptFeedback
مجموعه ای از فراداده های بازخوردی که در GenerateContentRequest.content
مشخص شده است.
نمایندگی JSON |
---|
{ "blockReason": enum ( |
زمینه های | |
---|---|
blockReason | اختیاری. در صورت تنظیم، درخواست مسدود شده است و هیچ نامزدی برگردانده نمی شود. درخواست خود را دوباره بیان کنید. |
safetyRatings[] | رتبه بندی برای ایمنی سریع. حداکثر یک رتبه برای هر دسته وجود دارد. |
BlockReason
مشخص می کند که دلیل مسدود شدن درخواست چه بوده است.
Enums | |
---|---|
BLOCK_REASON_UNSPECIFIED | مقدار پیش فرض. این مقدار استفاده نشده است. |
SAFETY | درخواست به دلایل ایمنی مسدود شد. میتوانید safetyRatings بررسی کنید تا متوجه شوید کدام دسته ایمنی آن را مسدود کرده است. |
OTHER | درخواست به دلایل نامعلوم مسدود شد. |