이미지
이미지 변형 생성
주어진 이미지의 변형을 생성합니다
개요
이 엔드포인트는 기존 OpenAI 호환 variation 클라이언트를 위해 유지됩니다. 현재 image-to-image 워크플로에는 권장 경로가 아닙니다. 가능하면 /v1/images/edits와 gpt-image-2를 사용하거나 /v1/images/generations에서 nano-banana-pro 같은 image-to-image 모델을 사용하세요. multipart/form-data가 필요합니다.
요청 본문
동기 요청 타임아웃: 일부 라우팅된 이미지 제공자는 생성이 완료될 때까지 기다린 뒤 최종 이미지를 inline 으로 반환합니다. 고해상도 또는 고품질 요청은 1분 안팎이거나 그 이상 걸릴 수 있으므로 HTTP 클라이언트 타임아웃을 최소 120s 로 설정하세요. 생성 응답에 status: "pending", task_id, 또는 poll_url 이 포함되어 있으면 반환된 poll_url 을 따라 폴링하세요.
Multipart 원본 이미지입니다. 파일과 전체 요청 본문은 각각 50 MiB 이하여야 합니다. 지원 형식과 크기는 모델에 따라 다르며 현재 모델 상세 정보에 /v1/images/variations가 명시되어 있어야 합니다.
기존 variation 호환 라우트용 필수 모델 ID입니다. 암시적 기본값은 없습니다. 현재 image-to-image 워크플로에서는 현재 모델과 함께 /v1/images/edits 또는 /v1/images/generations를 우선 사용하세요.
1생성할 이미지 수입니다 (1-10, 모델에 따라 다름).
기존 variation 호환 라우트에서 생성되는 이미지 크기입니다. 지원 값은 선택한 모델에 따라 달라집니다.
생성된 이미지가 반환되는 형식. url 또는 b64_json이어야 합니다.
남용 모니터링을 위한 최종 사용자의 고유 식별자.
응답
이미지가 생성된 시점의 Unix 타임스탬프.
생성된 이미지 변형 배열.
각 객체에 포함된 항목:
url(string): 변형 이미지의 URL (response_format이url인 경우)b64_json(string): Base64로 인코딩된 이미지 (response_format이b64_json인 경우)
요청
curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
-H "Authorization: Bearer sk-your-api-key" \
-F "model=your-legacy-variation-model" \
-F "image=@cat.png" \
-F "n=2" \
-F "size=1024x1024"응답
{
"created": 1706000000,
"data": [
{
"url": "https://..."
},
{
"url": "https://..."
}
]
}참고 사항
이 엔드포인트는 기존 호환용이며 현재 추천 이미지 모델 카탈로그에 포함되지 않습니다. 새 연동에서는 /v1/images/edits와 gpt-image-2를 사용하거나 /v1/images/generations에서 operation: "image-to-image" 및 현재 image-to-image 모델을 사용하세요.
인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
헤더
요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.
허용 값
- "auto"
- "verified"
- "official"
요청 본문
multipart/form-data
응답
application/json
application/json
application/json
application/json
application/json
application/json