GPT Image 1

ID:openai/gpt-image-1

OpenAI의 GPT Image 1 이미지 생성 API — 강력한 프롬프트 준수와 최대 5장의 참조 이미지를 지원하는 OpenAI 최초의 GPT-4o 네이티브 이미지 모델.

텍스트-투-이미지이미지 편집참조 이미지

개요

OpenAI의 GPT Image 1 이미지 생성 API — 강력한 프롬프트 준수와 최대 5장의 참조 이미지를 지원하는 OpenAI 최초의 GPT-4o 네이티브 이미지 모델.

인증

모든 API 요청은 Authorization 헤더에 Bearer 방식으로 유효한 API 키를 전달해야 합니다.

빠른 시작

인증 정보

RUNBASE_API_KEY 환경 변수를 설정하세요.

Shell

export RUNBASE_API_KEY=your-api-key

실행 생성

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

실행

실행은 비동기로 처리됩니다. 요청을 제출한 후 결과를 폴링하세요.

실행 생성

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

실행 상태 조회

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

결과 조회

status가 "succeeded"가 될 때까지 상태 엔드포인트를 폴링한 후 응답에서 output.urls를 읽으세요.

입력 스키마

매개변수	유형	필수	설명
prompt	string	필수	Prompt
aspect_ratio	string	선택	Aspect ratio옵션: `1:13:22:3`
image_urls	string[]	선택	Reference images

출력 스키마

필드	유형	설명
urls	string[]	생성된 출력 URL

오류

API는 표준 HTTP 상태 코드를 사용하여 성공 또는 실패를 나타냅니다.

상태 코드	설명
400	잘못된 요청 - 매개변수가 누락되었거나 형식이 올바르지 않습니다
401	인증 실패 - API 키가 누락되었거나 유효하지 않습니다
402	크레딧 부족
403	접근 거부 - IP가 허용되지 않았거나 API 키 지출 한도 초과
404	실행을 찾을 수 없습니다
429	요청 속도 제한 초과
500	내부 서버 오류