가격 및 실제 청구 금액

curl --request GET \
  --url 'https://toapis.com/v1/pricing?model=seedance-2-5' \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "currency": "USD",
  "data": [
    {
      "id": "seedance-2-5",
      "type": "video",
      "prices": [
        {
          "group": "default",
          "conditions": {"resolution": "720p", "has_video_input": false},
          "charge_type": "per_token",
          "price_basis": "total_tokens",
          "unit": "1m_tokens",
          "unit_price": "4"
        }
      ]
    }
  ],
  "has_more": false,
  "next_after": ""
}

GET

pricing

curl --request GET \
  --url 'https://toapis.com/v1/pricing?model=seedance-2-5' \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "currency": "USD",
  "data": [
    {
      "id": "seedance-2-5",
      "type": "video",
      "prices": [
        {
          "group": "default",
          "conditions": {"resolution": "720p", "has_video_input": false},
          "charge_type": "per_token",
          "price_basis": "total_tokens",
          "unit": "1m_tokens",
          "unit_price": "4"
        }
      ]
    }
  ],
  "has_more": false,
  "next_after": ""
}

중국 본토에서는 Base URL로 https://toapis.cn을 사용하세요. 아래 예시의 https://toapis.com을 https://toapis.cn으로 바꾸면 됩니다.

GET /v1/pricing은 현재 API Key에서 사용할 수 있는 이미지 및 동영상 모델의 요금을 반환합니다. 고객별 고정 가격 또는 할인과 적용되는 그룹 가격이 이미 반영되어 있습니다. 이 엔드포인트는 요금 카탈로그를 반환합니다. 개별 생성 요청의 견적이 아니며 가격을 예약하거나 고정하지 않고, 생성 파라미터로 총비용을 계산하지 않습니다.

인증

string

필수

생성 API Key를 Bearer YOUR_API_KEY 형식으로 전송합니다.

쿼리 파라미터

string

정확한 모델 ID입니다. 생략하면 사용 가능한 모든 이미지 및 동영상 모델을 반환합니다.

string

image 또는 video로 필터링합니다.

integer

기본값:"100"

반환할 모델 수입니다. 1부터 100까지 지정할 수 있습니다.

string

이전 응답의 next_after를 페이지네이션 커서로 사용합니다.

Seedance 지역별 버전은 서로 다른 모델 ID를 사용합니다. 예를 들어 model에 seedance-2-5, seedance-2-5-cn, seedance-2-5-global을 지정합니다. 별도의 지역 쿼리 파라미터는 없습니다.

curl --request GET \
  --url 'https://toapis.com/v1/pricing?model=seedance-2-5' \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "currency": "USD",
  "data": [
    {
      "id": "seedance-2-5",
      "type": "video",
      "prices": [
        {
          "group": "default",
          "conditions": {"resolution": "720p", "has_video_input": false},
          "charge_type": "per_token",
          "price_basis": "total_tokens",
          "unit": "1m_tokens",
          "unit_price": "4"
        }
      ]
    }
  ],
  "has_more": false,
  "next_after": ""
}

위 금액은 응답 형식을 설명하기 위한 예시입니다. 현재 API Key에 실제로 반환된 가격을 사용하세요.

가격 필드

string

가격 통화입니다. 현재 USD입니다.

string

객체 유형입니다. 항상 list입니다.

array

사용 가능한 모델 목록입니다. 각 항목에는 정확한 모델 id, type, 0개 이상의 prices가 포함됩니다.

boolean

다음 페이지가 있는지 나타냅니다.

string

다음 요청에 사용할 커서입니다. has_more가 false이면 빈 문자열입니다.

string

가격이 적용되는 라우팅 그룹입니다. API Key가 자동 그룹 선택을 사용하면 여러 그룹이 반환될 수 있습니다.

object

가격이 적용되는 조건입니다. 가격에 영향을 주는 모델 기본값도 포함됩니다. 생성 요청을 이 값에 맞추세요.

string

per_request, per_second, per_token 중 하나입니다.

string

청구 기준입니다. request, output_seconds, total_tokens, text_input_tokens 중 하나입니다.

string

가격 단위입니다. request, second, 1m_tokens 중 하나입니다.

string

USD 기준 적용 단가를 10진수 문자열로 반환합니다. 고객 가격과 그룹 배율이 이미 반영되어 있으므로 그룹 배율을 다시 곱하지 마세요.

가격에는 input_unit_price, input_image_unit_price, free_input_image_count, minimum_charge_usd, image_token_prices가 포함될 수 있습니다. 시간대별 가격에는 pricing_period, pricing_timezone, pricing_schedule_version, pricing_peak_windows가 포함될 수 있습니다. 이미지 토큰 가격의 image_token_prices에는 text_input, cached_text_input, image_input, cached_image_input, image_output이 포함될 수 있습니다. 각 금액의 단위는 100만 토큰당 USD입니다. 표시된 조건과 호환되는 활성 후보 채널이 하나 이상 있는 가격만 반환합니다. 이 확인은 경로를 예약하거나 채널의 실시간 상태를 검사하지 않습니다. 안전하게 전체 가격을 공개할 수 없으면 모델이 반환되더라도 prices가 비어 있을 수 있습니다. 빈 배열이나 가격 항목 누락은 무료라는 뜻이 아닙니다.

실제 청구 금액

청구 금액을 확인할 수 있으면 생성 응답에 다음 객체가 포함됩니다.

{
  "billing": {
    "status": "settled",
    "credits": "100",
    "cost_usd": "0.5"
  }
}

필드	의미
`status`	`pending`, `settled`, `refunded` 중 하나
`credits`	확정된 ToAPIs Credits 사용량이며 10진수 문자열로 반환
`cost_usd`	같은 확정 청구의 USD 금액이며 10진수 문자열로 반환

pending은 최종 금액이 아직 확정되지 않았음을 뜻하며 금액 필드는 생략됩니다. refunded는 확정된 순 청구 금액이 0임을 뜻합니다. billing 객체 전체가 없으면 안전하게 공개할 값을 확인하지 못한 것이며 무료라는 뜻이 아닙니다. 이 객체는 다음 위치에 포함될 수 있습니다.

이미지 및 동영상 통합 작업 조회 GET /v1/tasks/{task_id}
비동기 이미지 작업 조회 GET /v1/images/generations/{task_id}
비동기 동영상 작업 조회 GET /v1/videos/generations/{task_id}
작업 Webhook의 data.billing
지원되는 비스트리밍 동기 이미지 생성 또는 편집 응답의 최상위 billing

비동기 작업은 완료 후 작업 조회를 최종 청구 금액의 대체 경로로 사용하세요. 스트리밍 이미지 응답, 지원되지 않는 공급자 응답 형식, Playground 요청, 지연 일괄 청구에서는 생략될 수 있습니다.

작업 사용량 필드

이미지와 동영상 작업 조회는 확인된 과금 수량을 최상위 usage에 반환합니다. 성공 Webhook의 data.usage도 같은 정의를 사용합니다. 과금 수량, 모델이 보고한 토큰 내역, 도구 사용 횟수는 각각 확인 가능한 경우 함께 반환됩니다.

필드	타입	설명
`charge_type`	string	과금 방식: `per_request`, `per_second`, `per_token`
`requests`	integer	실제 과금 요청 횟수. 일반 이미지 요청의 `n`을 이 횟수에 직접 곱하지 않습니다. Midjourney 동영상의 유효한 `batch_size`는 과금 횟수에 반영됩니다
`billed_tokens`	integer	가격 계산에 사용한 토큰 수. 일부 이미지 처리 경로는 설정된 선차감 토큰 기준을 사용하므로 실제 생성 토큰 수와 다를 수 있습니다
`output_seconds`	integer	과금 대상 출력 동영상 길이, 정수 초 단위
`input_seconds`	integer	과금 대상 입력 동영상 길이, 정수 초 단위
`input_images`	integer	무료 허용량을 제외한 과금 대상 입력 이미지 수
`input_tokens`, `output_tokens`, `prompt_tokens`, `completion_tokens`, `total_tokens`	integer	동영상 모델이 보고한 0 이상의 정수 토큰 내역. 공급자가 제공한 필드만 반환하며, 확정된 토큰 과금 정산으로 `total_tokens`를 채울 수 있습니다
`tool_usage`	object	`web_search`, `image_search`, `grounding_queries` 등의 도구 사용 횟수. 확인 가능한 필드만 반환하며 토큰 내역과 독립적입니다

과금 수량은 해당 작업에 저장된 과금 기록에서 가져옵니다. 고정 과금은 생성 시 확인한 수량을, 후정산은 최종 정산 수량을 사용합니다. 현재 가격이나 금액에서 사용량을 역산하지 않습니다. per_request는 requests, per_second는 output_seconds, per_token은 billed_tokens를 사용합니다. 입력 동영상과 이미지의 추가 과금 항목은 필요한 경우 반환하며 0이면 생략합니다. 과거 작업에 금액만 저장되어 검증 가능한 과금 수량이 없으면 확인할 수 없는 필드는 생략합니다. 제공되지 않은 토큰 내역을 0으로 채우지 않습니다. 토큰 과금 정산 후 동영상 토큰 내역은 보고된 합계가 최종 과금 수량과 일치할 때만 유지합니다. usage와 billing의 제공 여부는 독립적입니다. 사용량이 없어도 미과금을 의미하지 않으며 결과 반환도 막지 않습니다. 반대로 charge_type 등 과금 수량이 반환되면 billing.status=settled와 실제 금액도 항상 함께 반환됩니다. 제출 시 한 번에 과금되는 고정 과금 작업도 settled를 반환합니다. 작업 조회와 Webhook은 같은 확인 조건과 필드 값을 사용합니다.

오류

상태	코드	의미
`400`	`invalid_request_error`	지원되지 않는 쿼리 파라미터 또는 잘못된 `type` / `limit`
`401` / `403`	상황에 따라 다름	API Key가 잘못되었거나 만료 또는 제한되었거나, 해당 계정 또는 그룹을 사용할 수 없음
`404`	`model_not_found`	이 API Key에서 정확한 모델 ID를 사용할 수 없음
`503`	`pricing_unavailable`	고객 가격을 안전하게 불러올 수 없으며 공개 가격으로 대체하지 않음

응답에는 Cache-Control: private, no-store가 설정됩니다.

개요

빠른 시작

모델 카탈로그

채팅 API

이미지 API

비디오 API

음악 API

작업 관리

파일 업로드

계정

자주 묻는 질문

인증

쿼리 파라미터

가격 필드

실제 청구 금액

작업 사용량 필드

오류

​인증

​쿼리 파라미터

​가격 필드

​실제 청구 금액

​작업 사용량 필드

​오류

인증

쿼리 파라미터

가격 필드

실제 청구 금액

작업 사용량 필드

오류