الصور

Create Image

إنشاء صورة بناءً على مطالبة

POST
/v1/images/generations

نظرة عامة

استخدم 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.

مهام الصور والنتائج:

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} بدلاً من ذلك.

modelstringمطلوب

النموذج المراد استخدامه (على سبيل المثال، gpt-image-2، أو flux-pro-1.1، أو nano-banana-pro). استعلم عبر GET /v1/models?recommended_for=image للحصول على القائمة الموصى بها الحالية.

promptstringمطلوب

وصف نصي للصورة المطلوبة، حتى 32,000 حرف. مطلوب لكل نموذج تذكر تفاصيله الحقل prompt.

operationstring

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.

image_urlstring

عنوان URL عام للصورة لتوليد image-to-image. لطلبات الصور المرجعية لـ Nano Banana، اضبط operation على image-to-image؛ قد يتضمن nano-banana-pro المعلمة resolution.

image_urlsstring[]

عناوين URL عامة للصور المرجعية، حتى 16 صورة. استخدم هذا لصورة مرجعية واحدة أو أكثر في طلبات JSON. لا يتم دعم file_id وimages[] على نقطة النهاية هذه.

reference_image_urlsstring[]

عناوين URL إضافية للصور المرجعية، حتى 16، للنماذج التي تميز المدخلات الأساسية عن المراجع.

imagefile

ملف صورة مرجعية بصيغة multipart لتوليد image-to-image. استخدم هذا عندما تكون الصورة المصدر خاصة أو محمية بترويسات. يختلف هذا عن file_id الخاص بـ /v1/files، والذي لا يتم قبوله على نقطة النهاية هذه.

nintegerالافتراضي: 1

عدد الصور المراد توليدها (1-10، يعتمد على النموذج).

sizestring

حجم الصورة. استخدم هذا لعائلات الصور المشابهة لأسلوب 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.

aspect_ratiostring

محدد نسبة العرض إلى الارتفاع ويعتمد على النموذج.

تتضمن القيم الشائعة لعائلة صور Google: 1:1، و16:9، و9:16، و3:2، و2:3.

resolutionstring

دقة الإخراج وتعتمد على النموذج. تدعم نماذج 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. احذف هذا الحقل ما لم يكن النموذج والعملية المحددان يدعمانه صراحةً.

qualitystring

جودة الصورة. تستخدم نماذج GPT Image مثل gpt-image-2 القيم auto، أو low، أو medium، أو high. قد تستخدم نماذج أخرى قيمًا مختلفة؛ تحقق من تفاصيل النموذج قبل إرسال قيمة غير افتراضية.

output_formatstring

تنسيق ملف الصورة: png أو jpeg أو webp. كما يقبل gpt-image-2.6-flare و gpt-image-2.6-sunburst التنسيقين svg و gif؛ راجع مخرجات SVG و GIF.

svgobject

إعدادات SVG، تُستخدم فقط مع output_format: "svg". يحدد model (مطلوب) نموذج المؤلف الذي يقوم بكتابة ملف SVG. ويقوم reasoning.effort اختياريًا بضبط مستوى جهد التفكير الخاص به.

frame_countintegerالافتراضي: 9

عدد إطارات GIF، من 2 إلى 16. تُستخدم فقط مع output_format: "gif".

frame_duration_msintegerالافتراضي: 200

مدة كل إطار في ملف GIF بالملي ثانية، من 20 إلى 2000. تُستخدم فقط مع output_format: "gif".

response_formatstring

طريقة إرجاع الصور: url أو b64_json.

  • محذوف: عندما يرجع النموذج بايتات الصورة، تكون كل صورة في data[].b64_json، وكذلك في data[].url عندما يقوم TokenLab بتخزينها. وعندما يرجع النموذج رابطًا، تكون كل صورة في data[].url.
  • url: تكون كل صورة في data[].url فقط.
  • b64_json: تكون كل صورة في data[].b64_json فقط كبيانات Base64.

الروابط هي عناوين URL لنتائج وسائط TokenLab. وتظل صالحة لمدة 30 يومًا. راجع الاحتفاظ بالبيانات.

asyncbooleanالافتراضي: 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.

stylestring

محدد النمط الاختياري. أرسل هذا فقط عندما يوثقه النموذج المحدد صراحةً؛ احذفه لـ gpt-image-2 ما لم تنص بيانات تعريف النموذج على خلاف ذلك.

userstring

معرف فريد للمستخدم النهائي.

تقبل بعض النماذج أيضًا حقولاً مثل negative_prompt، أو seed، أو width، أو height، أو steps، أو guidance_scale، أو mask_url. لا ترسلها إلا عندما تذكرها تفاصيل النموذج. القيمة stream: true غير مدعومة وتُرجع 400 unsupported_parameter.

الاستجابة (Response)

الاستجابة المضمنة (Inline Response)

createdinteger

الطابع الزمني بتنسيق Unix لإنشاء العنصر.

dataarray

مصفوفة من الصور المُولدة.

يحتوي كل كائن على:

  • url (سلسلة نصية): عنوان URL لنتيجة وسائط TokenLab للصورة، صالح لمدة 30 يومًا. غير موجود عندما يكون response_format هو b64_json. عند حذف response_format، يكون مفقودًا إذا لم يتمكن TokenLab من تخزين الصورة.
  • b64_json (سلسلة نصية): بيانات الصورة بتنسيق Base64. موجود عندما يكون response_format هو b64_json، أو عند حذفه وإرجاع النموذج لبايتات الصورة.
  • revised_prompt (سلسلة نصية): مراجعة المطالبة الاختيارية، عندما يرجعها النموذج المحدد
usageobject

أعداد الـ Tokens (input_tokens، وoutput_tokens، وtotal_tokens، وتفاصيلها) للنماذج المسعرة بالـ token مثل gpt-image-2، عندما تكون متاحة.

svg_usageobject

عدد الـ 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 خام، فاستخدم طلبًا متزامنًا.

قد يقوم نظام الفوترة بحجز المبلغ التقديري عند إنشاء المهمة. وتتم محاسبة المهام المكتملة بناءً على الاستخدام الفعلي، بينما يتم إلغاء حجز أو رد أموال المهام الفاشلة أو التي انتهت مهلتها.

createdinteger

الطابع الزمني بتنسيق Unix لإنشاء العنصر.

task_idstring

معرف مهمة فريد للاستقصاء.

statusstring

الحالة الأولية: pending.

poll_urlstring

عنوان URL نسبي لاستقصاء النتائج، على سبيل المثال /v1/tasks/{id}.

dataarray

فارغ طالما أن المهمة معلقة. تُرجع مهام الصور المكتملة عناوين URL للصور المُولدة في data[].url.

عندما تتلقى status: "pending"، استدعِ GET /v1/tasks/{task_id} لاسترداد النتيجة.

الطلب

cURL
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"
  }'
Python
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)
JavaScript
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
<?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_contractsize أو مستوى دقة لا يدعمه النموذج، أو يتعارض مع 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
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

الترويسات

X-TokenLab-Delivery-Policy?string

سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.

القيم المتاحة

  • "auto"
  • "verified"
  • "official"
Idempotency-Key?string

مفتاح اختياري يجعل طلب الصورة آمناً لإعادة المحاولة إذا قام الطلب بإنشاء مهمة. أرسل قيمة فريدة جديدة، مثل 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