메인 콘텐츠로 건너뛰기
POST
GPT-Image-2.6 이미지 생성
표준 티어는 POST /v1/images/generations로 이미지 작업을 생성하고 작업 ID를 반환합니다. 작업이 완료되면 상태 엔드포인트에서 이미지 URL을 가져옵니다. 두 모델 모두 동일한 요청 형식을 사용합니다: gpt-image-2.6은 시리즈 이름입니다. 반드시 표의 전체 모델명을 사용하세요.
중국 본토 사용자 안내: API 엔드포인트(Base URL)로 https://api.toapis.cn을 사용하세요. 이 문서의 예제에서 https://api.toapis.com을 https://api.toapis.cn으로 바꾸세요.
API Key는 콘솔에서 생성합니다.

빠른 시작

ToAPIs API Key를 TOAPIS_API_KEY 환경 변수로 설정한 후 작업을 제출합니다:
제출 응답 예시:
반환된 id를 저장하고 아래 TASK_ID를 해당 값으로 바꿔 결과를 조회합니다:
작업은 pending, queued, in_progress를 거쳐 completed 또는 failed가 됩니다. completed에서는 result.data에서 이미지 URL을, failed에서는 error를 읽습니다. 몇 초마다 폴링하세요. 전체 필드는 이미지 작업 상태 API를 참조하세요. 제출 성공은 작업이 생성되었다는 의미일 뿐입니다. 이미지 다운로드는 completed까지 기다리고, 기다리는 동안 동일한 작업 ID를 계속 폴링하세요.

요청 파라미터

string
필수
Bearer YOUR_TOAPIS_API_KEY로 인증합니다.
string
필수
gpt-image-2.6-flare 또는 gpt-image-2.6-sunburst.
string
필수
이미지 설명. 참조 이미지를 사용할 때는 유지할 대상과 변경할 내용을 설명하세요.
string
기본값:"high"
3단계: low, medium, high. Playground 기본값은 high. 생략하면 업스트림 기본값이 사용됩니다.
string
기본값:"1:1"
화면 비율. 예: 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9.size에 화면 비율을 지정하고 resolution을 명시적으로 전달하는 것을 권장합니다. 출력 픽셀 크기는 두 값으로 계산됩니다.auto를 전달해 업스트림이 크기를 정하게 할 수도 있지만, 최종 비율과 픽셀 크기는 보장되지 않습니다.
string
기본값:"1K"
해상도 티어. 1K, 2K, 4K를 지원하며 소문자도 허용됩니다. 표준 티어에서는 이 필드가 요금 티어를 결정합니다.
integer
기본값:1
요청당 1을 사용해 이미지 한 장을 생성합니다.
string
선택적 배경 설정. "transparent"로 투명 배경 이미지를 생성합니다. 일반 생성에서는 생략하세요.텍스트 생성과 reference_images가 포함된 요청 모두에서 사용할 수 있습니다.
string
출력 형식: png, jpeg, webp, gif, svg. 생략하면 업스트림 기본값이 사용됩니다. GIF 및 SVG의 추가 파라미터와 제한은 아래 각 섹션을 참조하세요.
integer
기본값:9
GIF 전용. 프레임 수 2~64. 텍스트-투-GIF는 이 값을 따르며, 이미지-투-GIF 출력은 항상 9프레임으로 렌더링됩니다.
integer
기본값:200
GIF 전용. 프레임당 밀리초 20~2000 (10 단위).
string[]
선택적 참조 이미지 URL 목록, 최대 10장. 이미지는 서버에서 접근 가능해야 합니다. URL만 지원되며 로컬 파일 업로드와 base64는 허용되지 않습니다. 로컬 이미지는 먼저 이미지 업로드 API로 URL을 얻으세요.image_urls도 허용됩니다. 둘 중 하나만 사용하세요."output_format": "gif"와 결합하면 이미지-투-GIF 출력이 됩니다.

투명 배경

생성 요청에 "background": "transparent"를 추가하면 투명 배경 이미지를 얻을 수 있습니다. 일반 생성에서는 생략하세요.
작업은 평소처럼 작업 ID로 조회하고 result.data에서 이미지 URL을 읽습니다.

GIF 출력

output_format을 gif로 설정하면 애니메이션을 생성합니다. frame_count가 프레임 수(264, 기본값 9)를, frame_duration_ms가 프레임당 시간(202000밀리초, 10 단위, 기본값 200)을 제어합니다.

이미지-투-GIF

reference_images를 추가하면 기존 이미지를 애니메이션화할 수 있습니다. 이미지-투-GIF 출력은 항상 9프레임으로 렌더링되며 frame_count는 이 모드에서 무시되지만 frame_duration_ms는 계속 적용됩니다.

SVG 출력

output_format을 svg로 설정하면 벡터 이미지를 생성합니다. 추가 필드는 필요 없습니다.

비율 및 해상도 예시

4K는 해상도 티이며 실제 너비와 높이는 화면 비율에 따라 달라집니다. 예를 들어 정사각형 4K 출력은 2880x2880입니다.

참조 이미지로 생성

같은 생성 엔드포인트에 reference_images를 최대 10장까지 추가합니다. 아래 예시는 Sunburst를 사용하며 비동기 작업을 반환합니다:
https://example.com/otter.png를 실제 참조 이미지 URL로 바꾼 후 반환된 작업 ID로 결과를 조회하세요.

요금

표준 티어는 생성된 이미지당 과금되며 resolution 티어가 요금 티어를 결정합니다. GIF와 SVG 출력도 동일한 이미지당 요금으로 과금됩니다. 참조 이미지 입력에는 현재 추가 요금이 없습니다. 계정별 가격이나 할인이 다를 수 있으니 최신 가격은 모델 요금 페이지와 계정 설정에서 확인하세요.

관련 모델

GPT-Image-2.6 Official 에디션은 공식 채널을 통해 6단계 품질, 사용자 지정 픽셀 크기, 마크업 가이드 편집, 토큰 기반 과금을 제공합니다. 해당 채널을 사용하려면 -official 접미사가 붙은 모델명을 사용하세요.