TokenLab

이미지

Create Image Variation

주어진 이미지의 변형을 생성합니다

POST
/v1/images/variations

개요

이 엔드포인트는 기존 OpenAI Variations 클라이언트를 지원합니다. 새로운 이미지 투 이미지(image-to-image) 기능의 경우, 최신 이미지 투 이미지 모델과 함께 /v1/images/edits 또는 /v1/images/generations를 사용하세요. 요청에는 multipart/form-data를 사용합니다.

요청 본문

이 엔드포인트는 동기식으로 동작합니다. 응답에는 작업이 아닌 최종 이미지가 포함됩니다. HTTP 클라이언트 타임아웃을 최소 120s 이상으로 설정하세요.

imagefile필수

멀티파트 소스 이미지입니다. 파일 및 전체 요청 본문은 각각 50 MiB 이하여야 합니다(더 큰 크기의 업로드는 413을 반환함). 지원되는 형식 및 크기는 선택한 모델에 따라 다릅니다. 상세 정보에서 image-to-image가 /v1/images/variations에 매핑된 모델만 허용되며, 그 외의 모델은 400을 반환합니다.

modelstring필수

모델 ID입니다. 이 엔드포인트에는 기본 모델이 없습니다. 예제에서는 플레이스홀더인 your-legacy-variation-model을 사용하므로, 상세 정보에 이 엔드포인트가 나열된 모델로 대체하여 사용하세요.

ninteger기본값: 1

생성할 이미지 수입니다 (1-10, 모델에 따라 다름).

sizestring

생성할 이미지 크기입니다. 지원되는 값은 선택한 모델에 따라 다릅니다.

response_formatstring

생성된 이미지가 반환되는 형식입니다. url 또는 b64_json이어야 합니다.

userstring

오남용 모니터링을 위해 최종 사용자를 식별하는 고유 식별자입니다.

응답

createdinteger

이미지가 생성된 시점의 Unix 타임스탬프입니다.

dataarray

생성된 이미지 변형 배열입니다.

각 객체에는 다음이 포함됩니다:

  • 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"

응답

Response
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

참고 사항

이 엔드포인트는 레거시 호환성을 위한 엔드포인트입니다. 현재 권장되는 이미지 모델 카탈로그에는 포함되어 있지 않습니다. 새로운 연동의 경우, gpt-image-2와 함께 /v1/images/edits를 사용하거나, operation: "image-to-image" 및 최신 이미지 투 이미지 모델과 함께 /v1/images/generations를 사용하세요.

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

헤더

X-TokenLab-Delivery-Policy?string

요청별 전송 정책입니다. 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