운영

프로덕션 체크리스트

비용, 작업, 웹훅, 오류 복구를 갖춘 안정적인 생성 연동 준비.

1분 분량2개 섹션

프로덕션 준비는 API 호출 전에 시작됩니다. 입력을 검증하고, 가격을 추정하고, taskId를 저장하고, 결과를 비동기로 처리하세요.

실무 핵심

속도, 충실도, 해상도, 제어 중 무엇이 우선인지에 따라 모델을 선택하고 모든 결과의 파라미터와 버전을 저장하세요. the model selected for the task — Production checklist.

한 번의 시도에서는 한 가지만 바꾸세요. 좋은 출력은 참조가 되며 다음 반복의 가장 신뢰할 수 있는 출발점입니다.

finished와 failed를 최종 상태로 다루세요. polling 또는 webhook을 사용하고 원본 오류는 서버에 보관하며 사용자에게는 안전한 메시지만 표시하세요.

프롬프트와 API 예시

json

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

json

{
  "code": 402,
  "error": {
    "message": "Insufficient balance. Please top up your account",
    "type": "PaymentRequired",
    "code": "insufficient_balance"
  }
}

  curl https://api.api-stock.com/api/v1/user/me \
    -H "Authorization: Bearer sk-your-key"

json

  {
    "code": 200,
    "data": {
      "id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18",
      "balance": 48250,
      "createdAt": "2026-01-14T09:03:11.000Z"
    }
  }

curl https://api.api-stock.com/api/v1/catalog

curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast

직접 발급한 키로 실행해 보세요

이 가이드에 나오는 모델은 모두 API Stock 카탈로그에서 바로 쓸 수 있습니다. API 키 하나, 선불 잔액 하나면 되고 공급자별 가입은 필요 없습니다.

카탈로그 보기 API 레퍼런스

이어서 읽기

실무 핵심

한 번의 시도에서는 한 가지만 바꾸세요. 좋은 출력은 참조가 되며 다음 반복의 가장 신뢰할 수 있는 출발점입니다.

finished와 failed를 최종 상태로 다루세요. polling 또는 webhook을 사용하고 원본 오류는 서버에 보관하며 사용자에게는 안전한 메시지만 표시하세요.

프롬프트와 API 예시

json

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

json

{
  "code": 402,
  "error": {
    "message": "Insufficient balance. Please top up your account",
    "type": "PaymentRequired",
    "code": "insufficient_balance"
  }
}

  curl https://api.api-stock.com/api/v1/user/me \
    -H "Authorization: Bearer sk-your-key"

json

  {
    "code": 200,
    "data": {
      "id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18",
      "balance": 48250,
      "createdAt": "2026-01-14T09:03:11.000Z"
    }
  }

curl https://api.api-stock.com/api/v1/catalog

curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast