Dùng GPT Image 2 trong Codex, Claude Code và các coding agent khác

Một coding agent như Codex hay Claude Code có thể tạo ảnh GPT Image 2 bằng cách gọi API trực tiếp. Hãy đặt khóa API vào một biến môi trường, đưa cho agent prompt bên dưới, và nó sẽ dựng yêu cầu, cho bạn xem, gửi đi sau khi bạn phê duyệt, truy vấn tác vụ và lưu ảnh vào dự án của bạn. Không cần plugin nào: một agent chạy được lệnh shell hoặc một script ngắn là gọi được API.

SeedRouter không cung cấp MCP server hay skill đóng gói sẵn. Prompt trong hướng dẫn này là toàn bộ phần tích hợp. Bạn có thể lưu nó thành một chỉ dẫn dùng lại được trong bất kỳ agent nào bạn dùng.

Agent cần gì trước khi bắt đầu?

Ba thứ:

1. Một khóa API trong biến môi trường. Tạo khóa trên trang khóa API và export nó trong shell mà agent chạy. Agent đọc khóa từ đó; nó không bao giờ được yêu cầu bạn dán khóa vào.
2. Quyền truy cập mạng. Agent gọi https://api.seedrouter.ai, nên sandbox của nó phải cho phép yêu cầu ra ngoài cho tác vụ này.
3. Tín dụng. Các yêu cầu được trả từ số dư của bạn, nên hãy nạp tiền trước lần chạy đầu tiên.

export SEEDROUTER_API_KEY="your-key"

Nên đưa cho agent prompt nào?

Dán đoạn này vào đầu tác vụ, rồi điền mục tiêu trong ngoặc vuông. Nó liệt kê chính xác các trường mà API chấp nhận, nên agent không bịa ra tham số, và nó buộc agent dừng lại chờ bạn phê duyệt trước khi bất cứ khoản phí nào phát sinh:

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.

Bước phê duyệt là quan trọng nhất. Một agent tự ý thử lại có thể gửi cùng một yêu cầu tính phí nhiều lần. Hãy giữ nguyên chỉ dẫn đó kể cả khi bạn đã tin tưởng thiết lập.

Dùng trong Codex thế nào?

Mở Codex trong dự án của bạn và dán prompt đã điền mục tiêu. Để dùng lại, hãy thêm prompt vào AGENTS.md của dự án, tệp chỉ dẫn mà Codex đọc cho kho mã, dưới một tiêu đề như "Generating images". Khi đó một yêu cầu như "tạo ảnh hero cho trang giá" là đủ; Codex sẽ làm theo các bước đã lưu.

Nếu Codex chạy trong sandbox không có quyền truy cập mạng, nó không thể gọi tới API. Hãy cho phép truy cập mạng cho phiên đó trước khi yêu cầu nó tạo ảnh.

Dùng trong Claude Code thế nào?

Cùng một prompt hoạt động trong Claude Code. Để dùng lại, hãy lưu nó trong CLAUDE.md của dự án, hoặc thành một skill: một thư mục có tệp SKILL.md với phần chỉ dẫn chứa prompt. Claude Code sẽ nạp nó khi bạn yêu cầu tạo ảnh. Hãy chắc chắn SEEDROUTER_API_KEY đã được export trong terminal mà bạn khởi động Claude Code.

Một lần chạy agent tốt trông như thế nào?

1. Bạn mô tả tấm ảnh và nơi nó sẽ được đặt.
2. Agent hiển thị ID mô hình, thân yêu cầu chính xác và chi phí ước tính, rồi chờ.
3. Bạn phê duyệt. Agent gửi đúng một lần và báo lại ID tác vụ.
4. Nó truy vấn cho tới khi tác vụ hoàn tất, tải ảnh vào dự án và cho bạn biết đường dẫn tệp.

Nếu một lần chạy dừng giữa chừng, ID tác vụ vẫn còn hiệu lực. Hãy yêu cầu agent tiếp tục truy vấn ID đó thay vì tạo lại; gửi lần thứ hai là bị tính phí lần thứ hai. Một tác vụ kết thúc ở trạng thái failed không bị tính phí.

Câu hỏi thường gặp

SeedRouter có MCP server hay skill cho GPT Image 2 không?

Không. Bản thân API là phần tích hợp, và prompt ở trên cho agent mọi thứ cần để gọi nó. Hãy lưu prompt thành một skill hoặc tệp chỉ dẫn trong agent của bạn nếu muốn dùng lại.

Agent có chỉnh sửa được ảnh có sẵn trong dự án của tôi không?

Có, nếu các ảnh đó truy cập được qua URL HTTPS công khai. API nhận ảnh tham chiếu và mặt nạ dưới dạng URL, không phải tệp cục bộ, nên hãy tải chúng lên trước hoặc cho agent biết chúng đang được lưu trữ ở đâu.

Agent nên dùng mô hình nào?

gpt-image-2 để trả một mức giá cố định cho mỗi ảnh được giao, hoặc gpt-image-2-official để trả theo số token mà mỗi lần dựng ảnh báo về. Thay mô hình trong prompt để chuyển đổi. Giá hiện tại có trên trang mô hình.

Giữ con người trong vòng kiểm soát

Đưa khóa cho agent qua biến môi trường, đưa các trường qua prompt, và giữ quyền quyết định cuối cùng qua bước phê duyệt. Sự kết hợp đó giúp Codex hay Claude Code tạo ảnh ngay trong dự án của bạn mà không có khoản phí bất ngờ. Tài liệu tham chiếu GPT Image 2 API có mọi trường nếu bạn muốn mở rộng prompt.