이미지
Create Image Variation
주어진 이미지의 변형을 생성합니다
개요
이 엔드포인트는 기존 OpenAI Variations 클라이언트를 지원합니다. 새로운 이미지 투 이미지(image-to-image) 기능의 경우, 최신 이미지 투 이미지 모델과 함께 /v1/images/edits 또는 /v1/images/generations를 사용하세요. 요청에는 multipart/form-data를 사용합니다.
요청 본문
이 엔드포인트는 동기식으로 동작합니다. 응답에는 작업이 아닌 최종 이미지가 포함됩니다. HTTP 클라이언트 타임아웃을 최소 120s 이상으로 설정하세요.
멀티파트 소스 이미지입니다. 파일 및 전체 요청 본문은 각각 50 MiB 이하여야 합니다(더 큰 크기의 업로드는 413을 반환함). 지원되는 형식 및 크기는 선택한 모델에 따라 다릅니다. 상세 정보에서 image-to-image가 /v1/images/variations에 매핑된 모델만 허용되며, 그 외의 모델은 400을 반환합니다.
모델 ID입니다. 이 엔드포인트에는 기본 모델이 없습니다. 예제에서는 플레이스홀더인 your-legacy-variation-model을 사용하므로, 상세 정보에 이 엔드포인트가 나열된 모델로 대체하여 사용하세요.
1생성할 이미지 수입니다 (1-10, 모델에 따라 다름).
생성할 이미지 크기입니다. 지원되는 값은 선택한 모델에 따라 다릅니다.
생성된 이미지가 반환되는 형식입니다. 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://..."
}
]
}참고 사항
이 엔드포인트는 레거시 호환성을 위한 엔드포인트입니다. 현재 권장되는 이미지 모델 카탈로그에는 포함되어 있지 않습니다. 새로운 연동의 경우, gpt-image-2와 함께 /v1/images/edits를 사용하거나, operation: "image-to-image" 및 최신 이미지 투 이미지 모델과 함께 /v1/images/generations를 사용하세요.
인증
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
application/json
application/json