الأخطاء
كيف تفسّر أخطاء الطلبات ومهام الصور الفاشلة.
كيف تقرأ الخطأ
تصف حالة HTTP الطلب المُرسل إلى الواجهة، بينما يصف error.code سبب الإخفاق. وهما حقلان منفصلان: رمز HTTP 200 ليس رمز خطأ في منطق العمل.
- يعيد الإرسال المرفوض حالة HTTP للخطأ مصحوبة بكائن
error. - يعيد الاستعلام الناجح عن مهمة رمز HTTP 200. اقرأ
statusلتعرف ما إذا كان الإنشاء في حالةprocessingأوcompletedأوfailed. - في المهام الفاشلة، فرّع منطق تطبيقك على
error.codeلا على نصmessage. فلأسباب الإخفاق المختلفة رموز مختلفة، والسبب نفسه يستخدم الرمز نفسه في جميع النماذج. - يُستخدم
60002كقيمة احتياطية حين يتعذّر تحديد سبب عام أدق. وعامِل أي رموز جديدة لا تعرفها مستقبلًا على أنها إخفاق عام.
ترجع الواجهة رموز الأخطاء ورسائلها في الجدول أدناه كما هي، ولذلك تبقى بالإنجليزية: فهي مطابقة حرفًا بحرف لقيمة error.message التي يستلمها عميلك فعليًا.
Request errors
These HTTP statuses describe a rejected or unconfirmed submission, or a failed task query. A submission timeout does not prove that no task was created.
Error code (error.code) | HTTP status | Meaning | Next step |
|---|---|---|---|
10001 | 401 | The API key is missing or invalid. | Check the Authorization header and API key. |
10002 | 403 | You do not have permission to make this request. | Check access permissions. |
20001 | 400, 413, 422 | The request was rejected. Check the parameters against the API documentation. | Correct the request parameters before retrying. |
20002 | 400 | The requested model is not available. | Select a model listed in the model catalog. |
30001 | 402 | Not enough credits to run this request. | Add credits before submitting. |
30002 | 429 | Too many requests. Please wait and try again. | Wait and retry with backoff. Do not repeat accepted submissions. |
50001 | 404 | Task not found. | Check the task ID and use the owning account’s key. |
50002 | 503 | Submission could not be confirmed. Check your tasks before submitting again. | Check task history before submitting again; the request may have been accepted. |
90001 | 503 | The service is temporarily unavailable. | Back off; retain any task ID already received. |
Task failures
A successful task query returns HTTP 200 even when generation failed. Check status: "failed" and error.code in the response. These codes describe the task outcome, not the HTTP request. Failed tasks are not charged.
Error code (error.code) | Meaning | Next step |
|---|---|---|
20001 | The request was rejected. Check the parameters against the API documentation. | Correct the request parameters before retrying. |
50003 | The task did not complete within the allowed time. Please try again. | The task is not charged. You may submit a new task. |
60001 | The request was rejected by the content policy. Please revise the prompt or input images. | Revise the prompt or media input. |
60002 | Generation could not be completed. Please try again. | The task is not charged. You may submit a new task. |
60003 | No output was generated. Please revise the prompt or try again. | Revise the input or submit a new task. |
60004 | The generated output could not be delivered. Please try again. | The task is not charged. Try again later. |
90001 | The service is temporarily unavailable. | Back off; retain any task ID already received. |
{
"id": "task_...",
"status": "failed",
"error": {
"code": 60002,
"message": "Generation could not be completed. Please try again."
}
}وإذا انتهت مهلة الإرسال نفسه، فراجع سجل مهامك قبل إعادة الإرسال: فقد يكون الطلب الأول قد قُبل بالفعل.