שימוש ב-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". מעכשיו מספיקה בקשה כמו "צור תמונת hero לעמוד המחירים"; 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 מקבל תמונות ייחוס ומסכות ככתובות URL, לא כקבצים מקומיים, ולכן העלה אותן קודם או אמור לסוכן איפה הן מתארחות.

באיזה מודל הסוכן צריך להשתמש?

gpt-image-2 למחיר קבוע אחד לכל תמונה שנמסרה, או gpt-image-2-official לתשלום לפי הטוקנים שכל רינדור מדווח. החלף את המודל בפרומפט כדי לעבור ביניהם. המחירים הנוכחיים מופיעים בעמוד המודל.

השאר אדם בתוך הלולאה

תן לסוכן את המפתח דרך הסביבה, את השדות דרך הפרומפט, ואת המילה האחרונה דרך שלב האישור. השילוב הזה מאפשר ל-Codex או ל-Claude Code להפיק תמונות בתוך הפרויקט שלך בלי חיובים מפתיעים. תיעוד ה-API של GPT Image 2 מכיל את כל השדות אם אתה רוצה להרחיב את הפרומפט.