TokenLab

이미지

이미지 상태 가져오기

비동기 이미지 생성 작업의 상태 및 결과를 가져옵니다

GET
/v1/tasks/{id}

이미지 전용 경로인 /v1/images/generations/{id}와 /v1/images/{id}는 호환성 엔드포인트입니다. 기존 통합을 위해 계속 지원됩니다. 새로운 통합은 GET /v1/tasks/{id}를 폴링(poll)해야 합니다. 작업 상태 가져오기를 참조하세요.

경로 매개변수

idstringpath필수

초기 이미지 생성 요청에서 반환된 작업 ID입니다.

생성 응답에서 id 또는 task_id를 사용하세요.

/v1/images/{id} 호환성 별칭은 ldtask_...와 같은 공개 이미지 작업 ID를 허용합니다. 이 별칭은 /v1/images/generations/{id}와 동일한 인증, 소유권 확인, 결제 헤더, 터미널 스냅샷 및 응답 형식을 사용합니다.

만료되었거나 사용할 수 없는 공개 작업은 404 async_task_not_found를 반환할 수 있습니다. 현재 API 키에 대한 작업 소유권을 확인할 수 없는 경우 응답은 403 task_not_owned가 됩니다.

응답

결과, 오류, 타임스탬프 및 모델을 설명하는 필드는 작업에 대해 사용 가능한 경우 반환됩니다.

idstring

표준 비동기 작업 식별자입니다.

poll_urlstring

이 작업에 대한 상태 URL입니다. id를 사용하여 GET /v1/tasks/{id}를 폴링하세요.

createdinteger

생성된 Unix 타임스탬프입니다.

task_idstring

작업 식별자입니다.

statusstring

작업 상태: pending, processing, completed 또는 failed.

dataarray

생성된 이미지 배열(status가 completed일 때 채워짐).

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

  • url (string): 생성된 이미지의 TokenLab 미디어 결과 URL, 30일간 유효
  • revised_prompt (string): 선택한 모델이 반환하는 경우의 선택적 프롬프트 수정본
errorstring | object

작업이 실패한 이유(status가 failed일 때만): 문자열 또는 message를 포함하는 객체이며, 알려진 경우 type, code, param, retryable이 포함됩니다.

error_detailsobject

작업 실패 시의 상세 정보: status, message, type, code, retryable, 그리고 요청 필드에 문제가 있는 경우 param.

media_retentionobject

이미지 링크의 저장 상태: days 및 url, kind, status, expires_at을 포함하는 items[]. 생략될 수 있으며, 링크는 계속 작동합니다. 데이터 보존을 참조하세요.

usageobject

사용 가능한 경우 gpt-image-2와 같이 토큰 기반 가격 모델에 대한 토큰 수입니다.

요청

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

응답

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "data": []
}

확인 간격

상태가 pending 또는 processing인 동안 3~5초마다 확인하고, completed 또는 failed가 되면 중단하세요.

import requests
import time

def poll_image_task(task_id, api_key, max_wait=300, interval=3):
    """타임아웃을 포함한 이미지 생성 결과 폴링."""
    url = f"https://api.tokenlab.sh/v1/tasks/{task_id}"
    headers = {"Authorization": f"Bearer {api_key}"}

    start_time = time.time()
    while time.time() - start_time < max_wait:
        response = requests.get(url, headers=headers, timeout=30)
        response.raise_for_status()
        data = response.json()

        if data["status"] == "completed":
            return data["data"][0]["url"]
        elif data["status"] == "failed":
            raise Exception(data.get("error", "Generation failed"))

        time.sleep(interval)

    raise TimeoutError(f"Task {task_id} did not complete within {max_wait}s")

# 사용 예시
image_url = poll_image_task("ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sk-your-api-key")
print(f"Generated image: {image_url}")

인증

BearerAuth
AuthorizationBearer <token>

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

위치: header

경로 매개변수

id*string

id / task_id로 반환되거나 poll_url에 포함된 비동기 작업 ID입니다.

응답

application/json

application/json

application/json

application/json

application/json

application/json

application/json