Claude Opus 5.5을(를) SeedRouter에서 사용할 수 있습니다

Codex, Claude Code 등 코딩 에이전트에서 GPT Image 2 사용하기

Codex, Claude Code 등 코딩 에이전트가 내 API 키로 GPT Image 2 이미지를 만들게 하는 방법과, 유료 요청마다 먼저 확인을 받는 재사용 가능한 프롬프트를 소개합니다.

Markdown으로 읽기

Codex나 Claude Code 같은 코딩 에이전트는 API를 직접 호출해 GPT Image 2 이미지를 생성할 수 있습니다. API 키를 환경 변수에 넣고 에이전트에 아래 프롬프트를 주면, 에이전트가 요청을 만들어 보여 주고, 승인 후 제출하고, 작업을 폴링하고, 이미지를 프로젝트에 저장합니다. 플러그인은 필요 없습니다. 셸 명령이나 짧은 스크립트를 실행할 수 있는 에이전트라면 API를 호출할 수 있습니다.

SeedRouter는 MCP 서버나 패키지된 skill을 제공하지 않습니다. 이 가이드의 프롬프트가 연동의 전부입니다. 사용하는 에이전트에 재사용 가능한 지침으로 저장해 둘 수 있습니다.

에이전트가 시작하기 전에 무엇이 필요한가요?

세 가지입니다.

  1. 환경 변수의 API 키. API 키 페이지에서 키를 만들고, 에이전트가 실행되는 셸에서 export하세요. 에이전트는 거기서 키를 읽으며, 키를 붙여 넣으라고 요청해서는 안 됩니다.
  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를 열고 목표를 채운 프롬프트를 붙여 넣으세요. 재사용하려면 Codex가 저장소에서 읽는 지침 파일인 프로젝트의 AGENTS.md에 "Generating images" 같은 제목 아래 프롬프트를 추가하세요. 그러면 "가격 페이지용 히어로 이미지를 만들어 줘" 같은 요청만으로 충분하며, Codex가 저장된 단계를 따릅니다.

Codex가 네트워크 접근이 없는 샌드박스에서 실행되면 API에 닿을 수 없습니다. 생성을 요청하기 전에 해당 세션에서 네트워크 접근을 허용하세요.

Claude Code에서는 어떻게 사용하나요?

같은 프롬프트가 Claude Code에서도 작동합니다. 재사용하려면 프로젝트의 CLAUDE.md에 저장하거나, skill로 저장하세요. skill은 프롬프트를 지침으로 담은 SKILL.md 파일이 있는 폴더입니다. 그러면 이미지를 요청할 때 Claude Code가 이를 불러옵니다. Claude Code를 시작하는 터미널에서 SEEDROUTER_API_KEY가 export되어 있는지 확인하세요.

좋은 에이전트 실행은 어떤 모습인가요?

  1. 이미지와 그 이미지가 들어갈 위치를 설명합니다.
  2. 에이전트가 모델 ID, 정확한 요청 본문, 예상 비용을 보여 주고 기다립니다.
  3. 승인합니다. 에이전트는 한 번만 제출하고 작업 ID를 알려 줍니다.
  4. 작업이 완료될 때까지 폴링하고, 이미지를 프로젝트에 내려받은 뒤 파일 경로를 알려 줍니다.

실행이 중간에 멈춰도 작업 ID는 여전히 유효합니다. 다시 생성하지 말고 그 ID로 폴링을 재개하라고 에이전트에 요청하세요. 두 번째 제출은 두 번째 과금입니다. failed로 끝난 작업은 과금되지 않습니다.

자주 묻는 질문

SeedRouter에서 제공하는 GPT Image 2 MCP 서버나 skill이 있나요?

아니요. API 자체가 연동이며, 위 프롬프트가 에이전트가 API를 호출하는 데 필요한 모든 것을 제공합니다. 재사용하고 싶다면 사용하는 에이전트에 프롬프트를 skill이나 지침 파일로 저장하세요.

에이전트가 프로젝트의 기존 이미지를 편집할 수 있나요?

네, 이미지가 공개 HTTPS URL로 접근 가능하다면 가능합니다. API는 참조 이미지와 마스크를 로컬 파일이 아니라 URL로 받으므로, 먼저 업로드하거나 이미지가 호스팅된 위치를 에이전트에 알려 주세요.

에이전트는 어떤 모델을 써야 하나요?

전달된 이미지 1장마다 고정 가격을 원하면 gpt-image-2, 렌더링마다 보고된 토큰으로 결제하려면 gpt-image-2-official을 쓰세요. 바꾸려면 프롬프트의 모델을 교체하면 됩니다. 현재 가격은 모델 페이지에 있습니다.

사람이 최종 결정을 내리게 하세요

키는 환경 변수로, 필드는 프롬프트로, 최종 결정권은 승인 단계로 에이전트에 주세요. 이 조합으로 Codex나 Claude Code가 예상치 못한 과금 없이 프로젝트 안에서 이미지를 만들 수 있습니다. 프롬프트를 확장하고 싶다면 GPT Image 2 API 레퍼런스에 모든 필드가 있습니다.

관련 가이드