استخدام GPT Image 2 في Codex وClaude Code ووكلاء البرمجة الأخرى

يستطيع وكيل برمجة مثل Codex أو Claude Code توليد صور GPT Image 2 باستدعاء الـ API مباشرة. ضع مفتاح API في متغير بيئة، وأعطِ الوكيل الموجّه أدناه، وسيبني الطلب ويعرضه عليك ويرسله بعد موافقتك، ثم يستعلم عن المهمة ويحفظ الصور في مشروعك. لا حاجة إلى أي إضافة: فالوكيل الذي يستطيع تشغيل أمر shell أو سكربت قصير يستطيع استدعاء الـ API.

لا يوفّر SeedRouter خادم MCP ولا skill جاهزة. فالموجّه في هذا الدليل هو التكامل كله. ويمكنك حفظه تعليماتٍ قابلة لإعادة الاستخدام في أي وكيل تستخدمه.

ما الذي يحتاجه الوكيل قبل أن يبدأ؟

ثلاثة أشياء:

1. مفتاح API في البيئة. أنشئ مفتاحًا في صفحة مفاتيح API وصدّره في الـ shell الذي يعمل فيه الوكيل. يقرؤه الوكيل من هناك؛ ولا ينبغي أن يطلب منك لصقه أبدًا.
2. الوصول إلى الشبكة. يستدعي الوكيل https://api.seedrouter.ai، لذا يجب أن تسمح بيئته المعزولة بالطلبات الصادرة لهذه المهمة.
3. الرصيد. تُدفع الطلبات من رصيدك، لذا اشحن رصيدك قبل التشغيل الأول.

export SEEDROUTER_API_KEY="your-key"

أي موجّه تعطيه للوكيل؟

الصق هذا في بداية المهمة، ثم املأ الهدف بين الأقواس المعقوفة. فهو يسرد الحقول التي تقبلها الـ API بالضبط، فلا يخترع الوكيل معاملات، ويجعل الوكيل يتوقف لأخذ موافقتك قبل احتساب أي شيء:

Use the SeedRouter API to generate a gpt-image-2 image for me.

Security: read SEEDROUTER_API_KEY from my local environment. Never ask me to paste it and never expose it in code, prompts, logs, or output.

Goal:
- Use case: [product / social / concept art / UI mockup]
- Subject and style: [subject, composition, lighting, style]
- Size: [auto | 1024x1024 | 1536x1024 | 1024x1536 | WIDTHxHEIGHT]
- Quality: [auto | low | medium | high]
- Number of images: [1-10]
- Acceptance criteria: [e.g. no text in the image, consistent product, clean background]

Request fields this endpoint accepts, and nothing else:
  model (required, "gpt-image-2"), prompt (required, up to 32000 chars),
  n (1-10, default 1), size (default auto; a custom WIDTHxHEIGHT must have
  both sides divisible by 16, neither edge over 3840, total pixels between
  655360 and 8294400, and keep a ratio between
  1:3 and 3:1), quality (auto|low|medium|high, default auto),
  background (auto|opaque|transparent, default auto; transparent requires
  output_format png), output_format (png|jpeg, default png),
  output_compression (0-100, default 100, jpeg only),
  moderation (auto|low, default auto), user (your own identifier).
For editing use /v1/images/generations with images: [{image_url: "https://..."}]
(up to 16) and optional mask: {image_url: "https://..."}. Mask requires images.
Inputs must be URLs, not base64 or multipart files. stream and partial_images
are not supported because delivery is asynchronous.

Before any paid request, show me the model id, the exact request body and the
estimated cost, then wait for my explicit approval.

After approval:
1. POST https://api.seedrouter.ai/v1/images/generations with the body above and
   an Authorization: Bearer $SEEDROUTER_API_KEY header.
2. Save the task id from the response "id" field. The response is
   {"id": "...", "status": "processing"} — the image is not in it.
3. Poll https://api.seedrouter.ai/v1/tasks/{task_id} with the same header every
   5-10 seconds until status is "completed" or "failed". Do not retry forever;
   if you stop waiting, preserve the task id and report that it is still pending.
   A polling timeout is not a failed task. Never submit a duplicate just to check status.
4. On success, download every URL in output.data[].url, return the local paths,
   the task id, and the parameters used. The response carries no cost field.
5. On failure, keep the task id, explain the reason and what to change, and do
   not retry without my approval. A task that ends failed is not charged.

خطوة الموافقة هي الأهم. فالوكيل الذي يعيد المحاولة من تلقاء نفسه قد يرسل الطلب المدفوع نفسه عدة مرات. أبقِ هذه التعليمات في مكانها حتى بعد أن تثق بالإعداد.

كيف تستخدمه في Codex؟

افتح Codex في مشروعك والصق الموجّه بعد ملء هدفك. ولإعادة استخدامه، أضف الموجّه إلى ملف AGENTS.md في المشروع، وهو ملف التعليمات الذي يقرؤه Codex للمستودع، تحت عنوان مثل "Generating images". عندها يكفي طلب مثل "اصنع صورة رئيسية لصفحة الأسعار"؛ فيتبع Codex الخطوات المحفوظة.

إذا كان Codex يعمل في بيئة معزولة دون وصول إلى الشبكة، فلن يتمكن من الوصول إلى الـ API. اسمح بالوصول إلى الشبكة في تلك الجلسة قبل أن تطلب منه التوليد.

كيف تستخدمه في Claude Code؟

يعمل الموجّه نفسه في Claude Code. ولإعادة الاستخدام، احفظه في ملف CLAUDE.md الخاص بالمشروع، أو بصفته skill: مجلدًا فيه ملف SKILL.md تتضمن تعليماته الموجّه. عندها يحمّله Claude Code حين تطلب صورة. وتأكد من تصدير SEEDROUTER_API_KEY في الطرفية التي تشغّل منها Claude Code.

كيف يبدو تشغيل جيد للوكيل؟

1. تصف الصورة والمكان الذي يجب أن توضع فيه.
2. يعرض الوكيل معرّف النموذج وجسم الطلب الدقيق وتكلفة تقديرية، ثم ينتظر.
3. توافق. فيرسل الوكيل مرة واحدة ويبلغك بمعرّف المهمة.
4. يستعلم حتى تكتمل المهمة، وينزّل الصور إلى المشروع ويخبرك بمسارات الملفات.

إذا توقف التشغيل في منتصفه، يبقى معرّف المهمة صالحًا. اطلب من الوكيل استئناف الاستعلام عن ذلك المعرّف بدلًا من التوليد مجددًا؛ فالإرسال الثاني احتساب ثانٍ. والمهمة التي تنتهي بالفشل لا تُحتسب.

الأسئلة الشائعة

هل يوفّر SeedRouter خادم MCP أو skill لـ GPT Image 2؟

لا. الـ API نفسها هي التكامل، والموجّه أعلاه يعطي الوكيل كل ما يحتاجه لاستدعائها. احفظ الموجّه بصفته skill أو ملف تعليمات في وكيلك إذا أردته قابلًا لإعادة الاستخدام.

هل يستطيع الوكيل تحرير صور موجودة في مشروعي؟

نعم، إذا كانت الصور متاحة عبر روابط HTTPS عامة. تأخذ الـ API الصور المرجعية والأقنعة روابطَ لا ملفات محلية، لذا ارفعها أولًا أو أخبر الوكيل بمكان استضافتها.

أي نموذج يجب أن يستخدمه الوكيل؟

gpt-image-2 لسعر ثابت واحد لكل صورة تُسلَّم، أو gpt-image-2-official للدفع حسب التوكنات التي تبلّغ عنها كل عملية توليد. استبدل النموذج في الموجّه للتبديل. والأسعار الحالية في صفحة النموذج.

أبقِ الإنسان في الحلقة

أعطِ الوكيل المفتاح عبر البيئة، والحقول عبر الموجّه، والكلمة الأخيرة عبر خطوة الموافقة. هذا المزيج يتيح لـ Codex أو Claude Code إنتاج الصور داخل مشروعك دون تكاليف مفاجئة. ويضم مرجع GPT Image 2 API كل حقل إذا أردت توسيع الموجّه.