이미지 생성

​

각 엔드포인트 사용 시기

​

모델 선택

curl "https://api.tokenlab.sh/v1/models?recommended_for=image" \
  -H "Authorization: Bearer sk-your-api-key"

• 지원되는 작업, 예를 들어 text-to-image, image-to-image, 또는 image-edit.
• 모델이 예상하는 요청 엔드포인트.
• 참조에 사용할 모양, 예를 들어 image_url, image_urls, reference_image_urls, 멀티파트 image, 또는 JSON images[].
• 모델이 size, aspect_ratio, resolution, quality, background, output_format, 또는 response_format을 수용하는지 여부.

​

요청 형식 규칙

• gpt-image-2 스타일 요청은 OpenAI와 유사한 size, quality, 및 편집 필드를 사용합니다. 모델이나 TokenLab이 자동 기본값을 사용하도록 하려면 선택적 필드를 생략하십시오.
• 제미니 및 나노 바나나 이미지 패밀리는 일반적으로 aspect_ratio를 사용합니다; 모델 계약이 이를 노출할 때만 resolution을 전송하십시오.
• 나노 바나나 이미지-투-이미지는 /v1/images/generations에서 operation: "image-to-image" 및 참조 이미지 URL과 함께 사용해야 합니다.
• /v1/images/generations는 최상위 images[] 또는 file_id를 수용하지 않습니다; 이는 편집 흐름 형식입니다.
• 원격 이미지 참조는 공개 http 또는 https URL이어야 합니다. 개인 네트워크 URL, 내장된 자격 증명, URL 조각, 또는 처리 시작 전에 만료될 수 있는 서명된 URL을 전송하지 마십시오.

​

텍스트-투-이미지 예제

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "호두 나무 책상 위에 있는 세라믹 커피 컵의 깔끔한 제품 사진",
    "size": "1024x1024",
    "response_format": "url"
  }'

​

참조 이미지 예제

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "operation": "image-to-image",
    "prompt": "제품 모양을 유지하고 배경을 밝은 스튜디오 설정으로 변경",
    "image_urls": ["https://example.com/input/product.png"],
    "aspect_ratio": "1:1"
  }'

​

결과 처리

• 동기 응답은 최종 data[]를 url 또는 b64_json과 함께 반환합니다.
• 비동기 응답은 id, task_id, status, 및 일반적으로 poll_url을 반환합니다.
• poll_url이 있을 때 이를 선호하십시오. 고정 경로가 필요하면 GET /v1/tasks/{id}를 폴링하십시오.
• b64_json이 필요할 때는 동기 요청을 사용하십시오; 비동기 이미지 결과는 URL 지향적입니다.

curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"

​

프로덕션 체크리스트

• TokenLab을 호출하기 전에 사용자 입력을 검증하십시오: 프롬프트 길이, 이미지 수, URL 도달 가능성, 및 파일 유형.
• 동기 고해상도 요청을 위해 HTTP 타임아웃을 충분히 높게 설정하십시오. 긴 작업을 위해 사용 가능한 경우 비동기 모드를 사용하십시오.
• 지원을 위해 request_id, task_id, poll_url, 모델, 엔드포인트, 및 정제된 요청 형식을 저장하십시오.
• 클라이언트 타임아웃 시, 생성 요청을 재시도하기 전에 작업이 생성되었는지 확인하십시오.
• 제공자 작업 ID가 아닌 사용 기록 및 billing_transaction_id와 비용을 조정하십시오.

​

일반적인 오류

​

API 참조