모델 가격 조회
계정 또는 키 관점의 현재 모델 가격 카탈로그 조회
중국 본토 사용자 안내: 중국 본토 사용자는 https://api.toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://api.toapis.com 을 https://api.toapis.cn 로 바꿔 주세요.
동작
현재 계정에서 사용 가능한 모델 요금 카탈로그를 반환하여 각 모델의 과금 방식과 단가를 확인합니다. api_key_id를 지정하면 특정 키 관점의 카탈로그입니다. 기존 GET /v1/pricing과 동일한 카탈로그 계산을 공유하지만 인증 방식, 매개변수, 응답 구조는 다릅니다.
카탈로그는 현재 요율을 보여줄 뿐 생성 요청 견적이 아니며 총액 추정이나 가격 고정에도 쓸 수 없습니다. 실제 청구 금액은 실제 비용과 작업 사용량을 참조하세요.
요금 지역은 계정으로 결정되고 region, group, after, 생성 파라미터는 받지 않습니다. 계정에 유효한 요금 지역이 하나도 없으면 503을 반환하며, 이 빈 결과를 계정의 요금 지역 설정으로 저장하지도 않습니다.
계정 관점은 계정의 유효 기본 그룹을 사용하고 api_key_id 지정 시 대상 키의 그룹과 모델 제한도 적용합니다. 대상 키가 삭제됐거나 타인 소유이거나 scope가 있으면 404, 그룹을 사용할 수 없으면 403 (code=13003)입니다.
meta.key_status는 대상 키의 설정 상태만 나타낼 뿐 현재 사용 가능 여부가 아닙니다.
전체 카탈로그는 가격을 확인할 수 없는 모델을 건너뛰며 가격이 없다고 무료는 아닙니다. model 지정 시: 보이는 카탈로그에 없으면 404 (code=16008), 보이지만 가격 미확정이면 503 (code=18029), 카탈로그 의존 장애는 503 (code=18028)입니다.
설정 변경으로 커서가 무효가 될 수 있고 한 번의 페이징 중에도 가격 스냅샷 일관성은 보장되지 않습니다.
인증
Authorizationstring헤더필수Bearer YOUR_SYSTEM_ACCESS_TOKEN을 사용합니다. 모델 키는 허용하지 않으며 X-User-Id는 필요하지 않습니다. 공통 규칙은 시작하기를 참조하세요.
요청 매개변수
api_key_idstring쿼리선택 사항인 소유한 미삭제 일반 키의 가격 설정. 생략하면 계정 설정. 비활성화, 만료, 소진 상태도 가격 설정은 조회할 수 있지만 호출 가능함을 뜻하지 않습니다.
modelstring쿼리정확한 모델 ID, 최대 255바이트.
typestring쿼리모델 유형: image, video, audio.
limitinteger쿼리기본값: 100페이지 크기, 기본 100, 범위 1-100.
cursorstring쿼리이전 next_cursor, 최대 2048바이트. 필터나 가격 컨텍스트 변경 시 처음부터 조회.
요청 예제
요청 예시
curl --request GET \
--url 'https://api.toapis.com/api/v1/pricing?type=image&limit=20' \
--header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'import requests
response = requests.get(
"https://api.toapis.com/api/v1/pricing",
headers={"Authorization": "Bearer YOUR_SYSTEM_ACCESS_TOKEN"},
params={"type": "image", "limit": "20"},
timeout=30,
)
response.raise_for_status()
print(response.json())const response = await fetch("https://api.toapis.com/api/v1/pricing?type=image&limit=20", {
method: "GET",
headers: { Authorization: "Bearer YOUR_SYSTEM_ACCESS_TOKEN" },
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
console.log(await response.json());응답 필드
예제는 가상 데이터입니다. 공통 응답과 오류는 시작하기를 참조하세요.
data.itemsarrayid, type, prices를 포함한 모델 목록.
data.meta.currencystring통화, 항상 USD.
data.meta.contextstring가격 컨텍스트: account 또는 api_key.
data.meta.api_key_idstring | null대상 키 ID, 계정 컨텍스트이면 null.
data.meta.key_statusstring | null대상 키 상태, 계정 컨텍스트이면 null.
data.meta.regionstring유효 지역: cn 또는 global.
data.has_moreboolean다음 페이지 여부.
data.next_cursorstring | null다음 커서, 마지막 페이지는 null.
prices[].groupstring가격이 적용되는 라우팅 그룹입니다. API Key가 자동 그룹 선택을 사용하면 여러 그룹이 반환될 수 있습니다.
prices[].conditionsobject가격이 적용되는 조건입니다. 가격에 영향을 주는 모델 기본값도 포함됩니다. 생성 요청을 이 값에 맞추세요.
prices[].charge_typestringper_request, per_second, per_token 중 하나입니다.
prices[].price_basisstring청구 기준입니다. request, output_seconds, output_videos, total_tokens, text_input_tokens 중 하나입니다.
prices[].unitstring가격 단위입니다. request, second, video, 1m_tokens 중 하나입니다.
prices[].unit_pricestringUSD 기준 적용 단가를 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입니다.
응답 예제
응답 예시
{
"code": 0,
"message": "",
"data": {
"items": [
{
"id": "example-image-model",
"type": "image",
"prices": [
{
"charge_type": "per_request",
"unit": "request",
"unit_price": "0.05",
"price_basis": "request",
"group": "default",
"conditions": {
"size": "1024x1024"
}
}
]
}
],
"has_more": false,
"next_cursor": null,
"meta": {
"currency": "USD",
"context": "account",
"api_key_id": null,
"key_status": null,
"region": "global"
}
}
}