الصور
Create Image
إنشاء صورة بناءً على مطالبة
نظرة عامة
استخدم GET /v1/models?recommended_for=image للحصول على نماذج الصور الحالية، ثم أرسل الـ model المحدد بشكل صريح.
يقبل كل نموذج عملياته وحقوله الخاصة. يوفّر GET /v1/models/{model} (Get Model) نقطة النهاية لكل عملية في tokenlab.request_format_summary.request_endpoint_by_operation، بالإضافة إلى الحقول والقيم والحدود المقبولة لكل عملية في tokenlab.request_format_details.operation_constraints. قد يؤدي إرسال حقل غير مدرج في النموذج إلى إرجاع 400 unsupported_parameter. كما تؤدي العملية المرسلة إلى نقطة نهاية خاطئة إلى إرجاع 400 unsupported_endpoint.
مهام الصور والنتائج:
- النماذج التي تُدرج
asyncضمن معلماتها المدعومة يمكنها إنشاء مهمة أولاً: أرسلasync: true، ثم قم بالاستقصاء (poll) عبرGET /v1/tasks/{id}. - يتم حفظ روابط الصور لمدة 30 يومًا؛ راجع الاحتفاظ بالبيانات.
- أرسل ترويسة
Idempotency-Keyلإعادة محاولة طلب الإنشاء بأمان بعد انتهاء المهلة؛ راجع إعادة المحاولة بأمان باستخدام مفتاح idempotency.
gpt-image-2 هو نموذج GPT Image يُسعر بناءً على الـ token. يتبع TokenLab تفصيل الاستخدام الرسمي من OpenAI لمدخلات النص، ومدخلات الصور، والمدخلات المخزنة مؤقتًا المُبلّغ عنها، وtokens مخرجات الصور؛ ولا يتم محاسبته كنموذج ذي سعر ثابت لكل صورة.
لتوليد الصور باستخدام gpt-image-2، المعلمات العامة المدعومة هي prompt، وn، وsize، وquality، وresponse_format، وasync، وbackground، وoutput_format، وoutput_compression أو compression، وmoderation، وuser. يقبل background القيمة auto أو opaque؛ القيمة transparent غير مدعومة. احذف size أو quality للسماح لـ TokenLab باستخدام auto؛ يجب أن تستخدم قيم size المخصصة صيغة WIDTHxHEIGHT المرنة الموضحة أدناه.
input_fidelity ليس جزءًا من الحقول المدعومة حاليًا في TokenLab لنموذج gpt-image-2؛ قم بحذفه وإلا سيعيد الطلب 400 unsupported_parameter.
مخرجات SVG و GIF
يمكن لـ gpt-image-2.6-flare و gpt-image-2.6-sunburst إرجاع ملف SVG أو ملف GIF متحرك بدلاً من صورة نقطية (raster image). بينما ترفض النماذج الأخرى هذه التنسيقات.
- SVG: أرسل
output_format: "svg"وsvg: {"model": "..."}. يقوم نموذج الصورة أولاً برسم صورة مرجعية، ثم يقوم نموذج التأليف بكتابة ملف SVG بناءً عليها.svg.modelمطلوب؛ حيث تسرد تفاصيل النموذج القيم المقبولة له ضمنparameter_options(svg.model). يمكنك أيضاً إرسالsvg.reasoning.effort. يعمل SVG فقط على نقطة النهاية هذه، معn: 1، وبدونpartial_imagesأوoutput_compression. - GIF: أرسل
output_format: "gif". يحددframe_count(من 2 إلى 16، القيمة الافتراضية 9) عدد الإطارات، ويحددframe_duration_ms(من 20 إلى 2000، القيمة الافتراضية 200) مدة كل إطار.sizeهو حجم الإطار الواحد. لا يقبل GIF كلاً منpartial_imagesأوoutput_compression.
تكون النتيجة في data[].b64_json أو data[].url، تماماً مثل الصور الأخرى. قم بفك ترميز SVG كنص XML بتنسيق UTF-8 واحفظه بصيغة .svg؛ واحفظ ملف GIF بصيغة .gif.
الفواتير: يتم محاسبة رموز (tokens) الصور وفقاً لأسعار رموز النموذج، وتُعتبر إطارات GIF بمثابة رموز مخرجات صور. كما يتم محاسبة طلب SVG أيضاً على رموز نموذج التأليف، والتي يبلغ عنها الرد في svg_usage، وذلك وفقاً لأسعار تأليف SVG الموضحة في صفحة النموذج.
ملاحظات حول سلوك النماذج
لا تتشارك نماذج عائلة صور Google Gemini نفس مواصفات محدد المعلمات:
- تدعم نماذج
gemini-3.1-flash-image، وgemini-nano-banana-2.1، وgemini-3-pro-image، وnano-banana-2.1، وnano-banana-proالمعلمةaspect_ratioبالإضافة إلىresolution(1k، و2k، و4k) لعمليات text-to-image، وimage-to-image، وimage-edit العامة الخاصة بها. - يدعم
nano-banana-2المعلمتينaspect_ratioوresolution(1k، و2k، و4k) لكل من توليد text-to-image وimage-to-image. - يدعم
gemini-3.1-flash-lite-imageوnano-banana-2-liteعمليات text-to-image، وimage-to-image، وimage-edit بدقة1kفقط. - يدعم
nano-bananaالمعلمةaspect_ratioولكنه لا يتيح تحديدresolutionبشكل عام. - بالنسبة لـ image-to-image مع
gemini-3.1-flash-image، أوgemini-nano-banana-2.1، أوgemini-3.1-flash-lite-image، أوgemini-3-pro-image، استخدم نقطة النهاية هذه معoperation: "image-to-image"وصور مرجعية. أرسل طلبات image-edit لهذه النماذج إلى/v1/images/edits. - لطلبات الصور المرجعية لـ Nano Banana، استخدم
nano-banana-2، أوnano-banana-2.1، أوnano-banana-2-lite، أوnano-banana-proعلى نقطة النهاية هذه (/v1/images/generations) معoperation: "image-to-image"وimage_urls. تستخدم طلبات image-edit لـnano-banana-2، وnano-banana-2.1، وnano-banana-2-lite، وnano-banana-proنقطة النهاية هذه أيضًا، معoperation: "image-edit". لا ترسل طلبات الصور المرجعية لـ Nano Banana إلى/v1/images/edits. - يمكن توفير الصور المرجعية على نقطة النهاية هذه كـ JSON
image_url/image_urls، أو كملفimageبصيغة multipart. لا يتم قبولimages[]وfile_idعلى/v1/images/generations؛ قم بإنشاء مراجع/v1/filesفقط لنماذج/v1/images/editsالتي توثقimages[].file_id.
بالنسبة لعائلات صور Google، يُفضل استخدام aspect_ratio وإرسال resolution فقط عندما يدعمها النموذج صراحةً.
تدعم نماذج صور xAI Grok Imagine (grok-imagine-image وgrok-imagine-image-2.0) المعلمة aspect_ratio بالإضافة إلى resolution (1k، و2k). يستخدم text-to-image نقطة النهاية هذه. وتستخدم طلبات image-to-image وimage-edit الخاصة بها نقطة النهاية /v1/images/edits.
ينشئ hy-image-v3.5-preview صورة واحدة بحجم 1024x1024 لكل طلب من النص على نقطة النهاية هذه ويدعم فقط response_format: "url". ويقوم بتعديل الصور المرجعية على /v1/images/edits.
جسم الطلب (Request Body)
مهلة الطلب المتزامن (Synchronous request timeout): تُرجع بعض طلبات الصور الصورة النهائية مضمنة (inline) وتنتظر حتى يكتمل التوليد. يمكن أن تستغرق الطلبات عالية الدقة أو عالية الجودة ما يقرب من دقيقة أو أكثر، لذا اضبط مهلة عميل HTTP الخاص بك على 120s على الأقل. إذا كانت استجابة الإنشاء تتضمن status: "pending"، أو task_id، أو poll_url، فاستقصِ عبر GET /v1/tasks/{task_id} بدلاً من ذلك.
النموذج المراد استخدامه (على سبيل المثال، gpt-image-2، أو flux-pro-1.1، أو nano-banana-pro). استعلم عبر GET /v1/models?recommended_for=image للحصول على القائمة الموصى بها الحالية.
وصف نصي للصورة المطلوبة، حتى 32,000 حرف. مطلوب لكل نموذج تذكر تفاصيله الحقل prompt.
text-to-image، أو image-to-image، أو image-edit. عند حذفه، يكون image-to-image إذا كان الطلب يحتوي على صورة مرجعية، وإلا يكون text-to-image. اضبطه على image-edit للنماذج التي تقع عملية التعديل الخاصة بها على نقطة النهاية هذه، مثل nano-banana-pro. يُرجع استخدام text-to-image مع صورة مرجعية الخطأ 400 invalid_parameter.
عنوان URL عام للصورة لتوليد image-to-image. لطلبات الصور المرجعية لـ Nano Banana، اضبط operation على image-to-image؛ قد يتضمن nano-banana-pro المعلمة resolution.
عناوين URL عامة للصور المرجعية، حتى 16 صورة. استخدم هذا لصورة مرجعية واحدة أو أكثر في طلبات JSON. لا يتم دعم file_id وimages[] على نقطة النهاية هذه.
عناوين URL إضافية للصور المرجعية، حتى 16، للنماذج التي تميز المدخلات الأساسية عن المراجع.
ملف صورة مرجعية بصيغة multipart لتوليد image-to-image. استخدم هذا عندما تكون الصورة المصدر خاصة أو محمية بترويسات. يختلف هذا عن file_id الخاص بـ /v1/files، والذي لا يتم قبوله على نقطة النهاية هذه.
1عدد الصور المراد توليدها (1-10، يعتمد على النموذج).
حجم الصورة. استخدم هذا لعائلات الصور المشابهة لأسلوب OpenAI والنماذج الأخرى التي تقبل أحجام بكسل دقيقة.
بالنسبة لـ gpt-image-2، يقبل size القيمة auto أو WIDTHxHEIGHT. يجب أن يكون كلا البعدين المخصصين من مضاعفات 16، ويجب ألا يتجاوز الحافة الأطول 3840px، ويجب ألا تتجاوز نسبة الطول إلى العرض 3:1، ويجب أن يكون إجمالي البكسلات بين 655,360 و8,294,400. المعلمتان aspect_ratio وresolution ليستا جزءًا من تفاصيل نموذج TokenLab الحالية لـ gpt-image-2.
بالنسبة لنماذج صور Google ذات مستويات الدقة (gemini-3.1-flash-image، وgemini-nano-banana-2.1، وgemini-3-pro-image، وgemini-3.1-flash-lite-image، وnano-banana-2، وnano-banana-2.1، وnano-banana-pro)، يقبل size حجم مخرجات من جدول أحجام النموذج، مثل 1376x768 (16:9 بدقة 1K)، أو مستوى دقة: 1K، أو 2K، أو 4K. يرسل TokenLab المستوى كـ resolution، لذا فإن الطلب وسعره يكونان متماثلين كما هو الحال مع resolution. أي مستوى لا يدعمه النموذج (على سبيل المثال 2K على gemini-3.1-flash-lite-image)، أو مستوى يختلف عن resolution، يُرجع 400 مع الرمز invalid_image_size_contract وallowed_resolutions الخاصة بالنموذج. بالنسبة لهذه النماذج، الصيغة الموصى بها هي aspect_ratio مع resolution.
محدد نسبة العرض إلى الارتفاع ويعتمد على النموذج.
تتضمن القيم الشائعة لعائلة صور Google: 1:1، و16:9، و9:16، و3:2، و2:3.
دقة الإخراج وتعتمد على النموذج. تدعم نماذج gemini-3.1-flash-image، وgemini-nano-banana-2.1، وgemini-3-pro-image، وnano-banana-2، وnano-banana-2.1، وnano-banana-pro القيم 1k، و2k، و4k؛ وتدعم نماذج صور Grok Imagine القيم 1k و2k. احذف هذا الحقل ما لم يكن النموذج والعملية المحددان يدعمانه صراحةً.
جودة الصورة. تستخدم نماذج GPT Image مثل gpt-image-2 القيم auto، أو low، أو medium، أو high. قد تستخدم نماذج أخرى قيمًا مختلفة؛ تحقق من تفاصيل النموذج قبل إرسال قيمة غير افتراضية.
تنسيق ملف الصورة: png أو jpeg أو webp. كما يقبل gpt-image-2.6-flare و gpt-image-2.6-sunburst التنسيقين svg و gif؛ راجع مخرجات SVG و GIF.
إعدادات SVG، تُستخدم فقط مع output_format: "svg". يحدد model (مطلوب) نموذج المؤلف الذي يقوم بكتابة ملف SVG. ويقوم reasoning.effort اختياريًا بضبط مستوى جهد التفكير الخاص به.
9عدد إطارات GIF، من 2 إلى 16. تُستخدم فقط مع output_format: "gif".
200مدة كل إطار في ملف GIF بالملي ثانية، من 20 إلى 2000. تُستخدم فقط مع output_format: "gif".
طريقة إرجاع الصور: url أو b64_json.
- محذوف: عندما يرجع النموذج بايتات الصورة، تكون كل صورة في
data[].b64_json، وكذلك فيdata[].urlعندما يقوم TokenLab بتخزينها. وعندما يرجع النموذج رابطًا، تكون كل صورة فيdata[].url. url: تكون كل صورة فيdata[].urlفقط.b64_json: تكون كل صورة فيdata[].b64_jsonفقط كبيانات Base64.
الروابط هي عناوين URL لنتائج وسائط TokenLab. وتظل صالحة لمدة 30 يومًا. راجع الاحتفاظ بالبيانات.
falseاضبطه على true لإنشاء مهمة أولاً. النماذج التي تدرج async ضمن المعلمات المدعومة لديها فقط هي التي تقبل ذلك، على سبيل المثال gpt-image-2 و flux-pro-1.1 و nano-banana-pro و seedream-5.0-lite؛ بالنسبة لأي نموذج آخر، يُرجع الطلب 400 unsupported_async_mode. تُرجع مهام الصور غير المتزامنة (async) المكتملة روابط URL بغض النظر عن response_format المطلوب؛ استخدم الطلبات المتزامنة (synchronous) عندما تحتاج إلى b64_json.
محدد النمط الاختياري. أرسل هذا فقط عندما يوثقه النموذج المحدد صراحةً؛ احذفه لـ gpt-image-2 ما لم تنص بيانات تعريف النموذج على خلاف ذلك.
معرف فريد للمستخدم النهائي.
تقبل بعض النماذج أيضًا حقولاً مثل negative_prompt، أو seed، أو width، أو height، أو steps، أو guidance_scale، أو mask_url. لا ترسلها إلا عندما تذكرها تفاصيل النموذج. القيمة stream: true غير مدعومة وتُرجع 400 unsupported_parameter.
الاستجابة (Response)
الاستجابة المضمنة (Inline Response)
الطابع الزمني بتنسيق Unix لإنشاء العنصر.
مصفوفة من الصور المُولدة.
يحتوي كل كائن على:
url(سلسلة نصية): عنوان URL لنتيجة وسائط TokenLab للصورة، صالح لمدة 30 يومًا. غير موجود عندما يكونresponse_formatهوb64_json. عند حذفresponse_format، يكون مفقودًا إذا لم يتمكن TokenLab من تخزين الصورة.b64_json(سلسلة نصية): بيانات الصورة بتنسيق Base64. موجود عندما يكونresponse_formatهوb64_json، أو عند حذفه وإرجاع النموذج لبايتات الصورة.revised_prompt(سلسلة نصية): مراجعة المطالبة الاختيارية، عندما يرجعها النموذج المحدد
أعداد الـ Tokens (input_tokens، وoutput_tokens، وtotal_tokens، وتفاصيلها) للنماذج المسعرة بالـ token مثل gpt-image-2، عندما تكون متاحة.
عدد الـ tokens الخاص بنموذج إنشاء الـ SVG (model, input_tokens, output_tokens, reasoning_tokens, total_tokens). يظهر فقط عند وجود مخرجات SVG. هذه الـ tokens غير مدرجة في usage ويتم محاسبتها وفقاً لأسعار إنشاء الـ SVG.
استجابة المهمة غير المتزامنة (Async Task Response)
اضبط async: true على نموذج يدعم ذلك لإنشاء مهمة بدلاً من انتظار الصورة النهائية في طلب الإنشاء. تتضمن الاستجابة status: "pending"، وtask_id، وpoll_url. استقصِ عبر /v1/tasks/{task_id} حتى تصل المهمة إلى completed أو failed.
تُرجع مهام الصور غير المتزامنة عناوين URL للصور النهائية فقط. إذا كنت بحاجة إلى بيانات صورة b64_json خام، فاستخدم طلبًا متزامنًا.
قد يقوم نظام الفوترة بحجز المبلغ التقديري عند إنشاء المهمة. وتتم محاسبة المهام المكتملة بناءً على الاستخدام الفعلي، بينما يتم إلغاء حجز أو رد أموال المهام الفاشلة أو التي انتهت مهلتها.
الطابع الزمني بتنسيق Unix لإنشاء العنصر.
معرف مهمة فريد للاستقصاء.
الحالة الأولية: pending.
عنوان URL نسبي لاستقصاء النتائج، على سبيل المثال /v1/tasks/{id}.
فارغ طالما أن المهمة معلقة. تُرجع مهام الصور المكتملة عناوين URL للصور المُولدة في data[].url.
عندما تتلقى status: "pending"، استدعِ GET /v1/tasks/{task_id} لاسترداد النتيجة.
الطلب
curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image",
"prompt": "A cinematic portrait of a white cat sitting on a rainy windowsill",
"aspect_ratio": "16:9",
"resolution": "2k"
}'from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://api.tokenlab.sh/v1"
)
response = client.images.generate(
model="gemini-3-pro-image",
prompt="A cinematic portrait of a white cat sitting on a rainy windowsill",
extra_body={"aspect_ratio": "16:9", "resolution": "2k"}
)
print(response.data[0].url)import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-api-key',
baseURL: 'https://api.tokenlab.sh/v1'
});
const response = await client.images.generate({
model: 'gemini-3-pro-image',
prompt: 'A cinematic portrait of a white cat sitting on a rainy windowsill',
aspect_ratio: '16:9',
resolution: '2k'
});
console.log(response.data[0].url);<?php
$ch = curl_init('https://api.tokenlab.sh/v1/images/generations');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer sk-your-api-key'
],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'gemini-3-pro-image',
'prompt' => 'A cinematic portrait of a white cat sitting on a rainy windowsill',
'aspect_ratio' => '16:9',
'resolution' => '2k'
])
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
echo $data['data'][0]['url'];مثال لعائلة صور تعتمد على النسبة فقط: لـ nano-banana، أرسل aspect_ratio ولكن احذف resolution:
{
"model": "nano-banana",
"prompt": "A clean editorial product shot of a citrus soda can",
"aspect_ratio": "16:9"
}مثال للصورة المرجعية لـ Nano Banana Pro: أرسل الطلب إلى /v1/images/generations، وليس /v1/images/edits. المعلمة resolution اختيارية ويمكن ضبطها على 1k، أو 2k، أو 4k:
{
"model": "nano-banana-pro",
"prompt": "Create a clean cinematic character image based on the reference images",
"operation": "image-to-image",
"image_urls": ["https://example.com/reference-1.png"],
"aspect_ratio": "1:1",
"resolution": "2k"
}مثال للرفع المباشر بصيغة multipart للصور المصدر الخاصة أو المحلية. لا تقم بتمرير file_id إلى /v1/images/generations:
curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-F "model=nano-banana-pro" \
-F "prompt=Create a clean cinematic character image based on this reference" \
-F "operation=image-to-image" \
-F "image=@reference.png" \
-F "aspect_ratio=1:1" \
-F "resolution=2k"الاستجابة
{
"created": 1706000000,
"data": [
{
"url": "https://...",
"revised_prompt": "A fluffy white cat with bright eyes sitting peacefully on a wooden windowsill, watching raindrops stream down the glass window..."
}
]
}الأخطاء (Errors)
تُرجع أخطاء الطلب الرمز 400 (413 لعمليات الرفع كبيرة الحجم) مع error.code. الرموز الشائعة لطلبات الصور:
| الرمز | السبب |
|---|---|
unsupported_parameter | النموذج لا يدرج الحقل، أو أن stream مضبوط على true |
unsupported_operation | لا توجد مثل هذه الـ operation للنموذج |
unsupported_endpoint | العملية الخاصة بهذا النموذج تقع على نقطة نهاية أخرى، مثل /v1/images/edits |
unsupported_async_mode | النموذج لا يدعم async: true |
invalid_resolution، invalid_aspect_ratio، invalid_parameter_value، too_many_items | القيمة تقع خارج ما يقبله النموذج. يحدد الخطأ القيم المقبولة |
invalid_image_size_contract | size أو مستوى دقة لا يدعمه النموذج، أو يتعارض مع resolution |
prompt_too_long | المطالبة أطول مما يقبله النموذج |
request_too_large، file_too_large | الرفع تجاوز حد الحجم (50 MiB لكل ملف، و200 MiB لجميع المدخلات) |
لمعرفة قواعد الرصيد (402)، وحد المعدل (429)، وإعادة المحاولة، راجع معالجة الأخطاء.
اختيار نموذج
استعلم عبر GET /v1/models?recommended_for=image أو استخدم صفحة النماذج لمعرفة التوفر والإمكانيات والأسعار الحالية.
لا تقم ببرمجة النموذج بشكل ثابت كنموذج متزامن دائمًا أو غير متزامن دائمًا. يمكن للطلب بدون async: true أن يُرجع status: "pending"؛ وكلما تضمنت استجابة الإنشاء status: "pending" أو status: "processing"، استقصِ عبر GET /v1/tasks/{task_id} حتى يكتمل الطلب.
التعامل مع الاستجابات القائمة على المهام
بالنسبة لنماذج الصور، تحقق دائمًا مما إذا كانت الاستجابة تحتوي على status: "pending" / status: "processing":
import requests
import time
def generate_image(prompt, model="gpt-image-2"):
# Create image request
response = requests.post(
"https://api.tokenlab.sh/v1/images/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={"model": model, "prompt": prompt, "async": True},
timeout=120
)
response.raise_for_status()
data = response.json()
# Check if task-based
if data.get("status") in ("pending", "processing"):
task_id = data["task_id"]
print(f"Image task started: {task_id}")
# Poll for result
deadline = time.time() + 600
while time.time() < deadline:
status_resp = requests.get(
f"https://api.tokenlab.sh/v1/tasks/{task_id}",
headers={"Authorization": "Bearer sk-your-api-key"},
timeout=30
)
status_resp.raise_for_status()
status_data = status_resp.json()
if status_data["status"] == "completed":
return status_data["data"][0]["url"]
elif status_data["status"] == "failed":
raise Exception(status_data.get("error", "Generation failed"))
time.sleep(3)
raise TimeoutError(f"Image task {task_id} did not finish in time")
else:
# Inline response
return data["data"][0]["url"]
# Usage
url = generate_image("a beautiful sunset over mountains", model="gpt-image-2")
print(f"Generated image: {url}")مثال Hy Image 3.5 Preview. يقبل size بالقيمة 1024x1024 وn بالقيمة 1 فقط:
{
"model": "hy-image-v3.5-preview",
"prompt": "A yellow lemon on a white table",
"size": "1024x1024",
"n": 1,
"response_format": "url"
}التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
الترويسات
سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.
القيم المتاحة
- "auto"
- "verified"
- "official"
مفتاح اختياري يجعل طلب الصورة آمناً لإعادة المحاولة إذا قام الطلب بإنشاء مهمة. أرسل قيمة فريدة جديدة، مثل UUID، لكل طلب. إعادة المحاولة بنفس المفتاح ونفس نص الطلب تُرجع تلك المهمة ولا تقوم بإنشاء أو إرسال أو احتساب تكلفة مهمة ثانية. بالنسبة للطلب الذي يُرجع الصورة مباشرة، قد تُرجع إعادة المحاولة بنفس المفتاح حالة المهمة بدلاً من الصورة، أو تُرجع 409 مع idempotent_response_not_replayable. يتم رفض نص الطلب المختلف الذي يستخدم مفتاحاً تم قبوله مسبقاً؛ ولا يوجد ضمان لرمز الحالة أو رمز الخطأ في هذه الحالة. يتم تجاهل المفتاح الذي يتجاوز 255 حرفاً، وعندها لا يتمتع الطلب بحماية idempotency. راجع إعادة المحاولة بأمان باستخدام مفتاح idempotency.
1 <= length <= 255الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json
application/json