메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
개요

주어진 이미지의 변형을 생성합니다. multipart/form-data 콘텐츠 타입이 필요합니다.

​
요청 본문

동기 요청 타임아웃: 일부 라우팅된 이미지 제공자는 생성이 완료될 때까지 기다린 뒤 최종 이미지를 inline 으로 반환합니다. 고해상도 또는 고품질 요청은 1분 안팎이거나 그 이상 걸릴 수 있으므로 HTTP 클라이언트 타임아웃을 최소 120s 로 설정하세요. 생성 응답에 status: "pending", task_id, 또는 poll_url 이 포함되어 있으면 반환된 poll_url 을 따라 폴링하세요.
​
image
file
필수
변형의 기반으로 사용할 이미지. 유효한 PNG 파일이어야 하며, 50MB 미만이고 정사각형이어야 합니다.
​
model
string
기본값:"dall-e-2"
이미지 변형에 사용할 모델. 현재 dall-e-2만 지원됩니다.
​
n
integer
기본값:"1"
생성할 이미지 수. 1에서 10 사이여야 합니다.
​
size
string
생성된 이미지의 크기. 256x256, 512x512 또는 1024x1024 중 하나여야 합니다.
​
response_format
string
기본값:"url"
생성된 이미지가 반환되는 형식. url 또는 b64_json이어야 합니다.
​
user
string
남용 모니터링을 위한 최종 사용자의 고유 식별자.

​
응답

​
created
integer
이미지가 생성된 시점의 Unix 타임스탬프.
​
data
array
생성된 이미지 변형 배열.각 객체에 포함된 항목:
  • 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 "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

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

​
참고 사항

이미지 변형은 DALL-E 2에서만 사용할 수 있습니다. 모델은 원본 이미지와 스타일 및 내용이 유사한 새 이미지를 생성합니다.