API 레퍼런스/모델 및 가격
모델 및 가격
이 엔드포인트로 지금 호출할 수 있는 모델과 컨텍스트 길이, 기능, 가격을 가져올 수 있어 모델 표를 직접 관리할 필요가 없습니다.
이 엔드포인트는 공개되어 있습니다. API 키가 필요 없으며 지금 호출할 수 있는 모델만 반환합니다. 요청은 API 호스트, 즉 모델 호출에 사용하는 것과 같은 base URL로 보내세요.
이 페이지 내용expand_more
모델 목록link
OpenAI 호환 모델 목록입니다. 기본적으로 텍스트 모델만 반환하므로, 모든 항목을 채팅 모델로 취급하는 클라이언트도 그대로 동작합니다.
GET
/v1/modelscURL
curl 'https://api.wokey.ai/v1/models'
curl 'https://api.wokey.ai/v1/models?output_modalities=all'쿼리 매개변수
output_modalities- 선택 사항. 출력 유형으로 필터링합니다: text, image, video, all 또는 text,image처럼 쉼표로 구분한 조합. 기본값은 text입니다. 잘못된 값을 보내면 400 invalid_output_modalities가 반환됩니다.
응답 필드
id- model로 보낼 모델 ID.
owned_by- 모델의 주 공급업체. 한 모델에 여러 공급업체가 있으면 전체 목록은 가격 카탈로그의 providers에 있습니다.
name- 표시 이름.
context_length- 토큰 단위의 컨텍스트 윈도우. 텍스트 모델만 해당.
max_completion_tokens- 요청당 최대 출력 토큰 수. 텍스트 모델만 해당.
architecture- input_modalities와 output_modalities는 모델이 지원하는 입력·출력 유형이며 이 값이 기준입니다. modality는 이들로 만든 표시용 문자열입니다.
pricing- 텍스트 모델 가격으로, 토큰당 USD를 10진수 문자열로 나타냅니다. prompt는 입력, completion은 출력이며 input_cache_read, input_cache_write, input_cache_write_1h는 캐시 읽기와 쓰기입니다. 모델이 지원하지 않는 항목은 생략됩니다.
supported_parameters- 모델이 지원하는 것으로 확인된 기능(예: max_tokens, tools).
JSON
{
"object": "list",
"data": [
{
"id": "deepseek-v4.1-flash",
"owned_by": "deepseek",
"object": "model",
"created": 0,
"name": "DeepSeek-V4.1-Flash",
"context_length": 1000000,
"max_completion_tokens": 393216,
"architecture": {
"modality": "text+image->text",
"input_modalities": ["text", "image"],
"output_modalities": ["text"]
},
"pricing": {
"prompt": "0.000000075",
"completion": "0.0000003",
"input_cache_read": "0.0000000015"
},
"supported_parameters": ["max_tokens", "tools"]
}
]
}샘플에는 모델 하나만 남기고 일부 필드는 생략했습니다.
- /models와 /v1/models는 같은 내용을 반환합니다.
- 응답에는 ETag가 포함됩니다. If-None-Match를 보내면 목록이 바뀌지 않았을 때 304가 반환되므로 폴링 부담이 적습니다.
- 일시적으로 용량이 가득 찬 모델도 목록에 남아 있으며, 용량이 확보될 때까지 해당 모델 호출은 429를 반환합니다.
가격 카탈로그link
지금 호출할 수 있는 모든 모델의 가격을 텍스트, 이미지, 동영상 공통의 한 가지 형식으로 제공합니다. 모델 목록과 달리 기본적으로 모든 유형을 반환합니다.
GET
/v1/models/pricingcURL
curl 'https://api.wokey.ai/v1/models/pricing?model=deepseek-v4.1-flash'
curl 'https://api.wokey.ai/v1/models/pricing?output_modalities=image,video'쿼리 매개변수
output_modalities- 선택 사항. 값은 모델 목록과 같으며 기본값은 all입니다.
model- 선택 사항. 모델 하나를 반환하며 대소문자를 구분하지 않고 일치시킵니다. 알 수 없는 모델 ID이면 빈 목록이 반환됩니다.
응답 필드
owned_by / providers- owned_by는 주 공급업체이고, providers는 현재 활성화된 공급업체를 기본 우선순위 순서로 provider 요청 매개변수가 받는 공급업체 ID로 나열합니다. 어느 공급업체가 요청을 처리하든 가격은 같습니다.
pricing_skus- 가격 항목 목록으로, 모든 모델에서 형식이 같습니다.
pricing_skus[].meter- 과금 대상. 텍스트 모델은 input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cache_write_5m_tokens, cache_write_1h_tokens를, 이미지는 output_images를, 동영상은 output_video를 사용합니다.
pricing_skus[].unit / quantity- 가격이 매겨지는 단위와 수량: 텍스트는 1,000,000토큰당, 이미지는 장당, 동영상은 초당입니다.
pricing_skus[].price_usd- USD 기준 Wokey 가격(10진수 문자열).
reference_price_usd / savings_pct- 텍스트 모델만 해당: 공식 참고 가격과 그 대비 할인율(퍼센트).
pricing_skus[].constraints- 가격이 적용되는 조건. 예: 이미지 크기 구간, 동영상 모드·해상도·길이 범위.
time_of_day- 시간대별로 가격이 정해지는 모델만 해당. current_tier는 현재 시간대(peak 또는 off_peak), peak_windows_utc는 피크 시간을 UTC로 나열하며, tiers는 두 시간대의 가격을 제공합니다. pricing_skus는 항상 현재 시간대를 표시합니다.
prompt_tiers- 입력 길이에 따라 가격이 정해지는 모델만 해당. 요청의 입력(캐시 읽기와 쓰기 포함)이 above_prompt_tokens를 넘으면 모든 과금 항목에 해당 구간의 가격이 적용됩니다.
JSON
{
"object": "list",
"data": [
{
"id": "deepseek-v4.1-flash",
"name": "DeepSeek-V4.1-Flash",
"owned_by": "deepseek",
"providers": ["deepseek", "opencode", "ollama", "volcengine"],
"object": "model",
"available": true,
"currency": "USD",
"pricing_skus": [
{
"sku_id": "deepseek-v4.1-flash:input_tokens",
"meter": "input_tokens",
"unit": "token",
"quantity": 1000000,
"price_usd": "0.075000",
"reference_price_usd": "0.150000",
"savings_pct": "50"
},
{
"sku_id": "deepseek-v4.1-flash:output_tokens",
"meter": "output_tokens",
"unit": "token",
"quantity": 1000000,
"price_usd": "0.300000",
"reference_price_usd": "0.600000",
"savings_pct": "50"
}
]
}
]
}샘플에는 모델 하나만 남기고 일부 필드는 생략했습니다.
- 가격은 시간대와 공급 상황에 따라 바뀔 수 있으므로 이 엔드포인트는 캐시되지 않으며 항상 현재 가격을 반환합니다.
이미지·동영상 모델link
cURL
curl 'https://api.wokey.ai/v1/images/models'
curl 'https://api.wokey.ai/v1/videos/models'