Referência da API/Modelos e preços
Modelos e preços
Use estes endpoints para obter os modelos que você pode chamar agora, com comprimento de contexto, recursos e preços, em vez de manter uma tabela de modelos à mão.
Estes endpoints são públicos: não exigem chave de API e retornam apenas os modelos que você pode chamar agora. Envie as requisições ao host da API, a mesma URL base que você usa para chamar os modelos.
Nesta páginaexpand_more
Lista de modeloslink
Uma lista de modelos compatível com OpenAI. Por padrão, retorna apenas modelos de texto, então clientes que tratam cada item como um modelo de chat funcionam sem ajustes.
/v1/modelscurl 'https://api.wokey.ai/v1/models'
curl 'https://api.wokey.ai/v1/models?output_modalities=all'Parâmetros de consulta
output_modalities- Opcional. Filtra pelo tipo de saída: text, image, video, all, ou uma combinação separada por vírgulas como text,image. O padrão é text. Um valor inválido retorna 400 invalid_output_modalities.
Campos da resposta
id- O ID do modelo a enviar em model.
owned_by- O fornecedor principal do modelo. Quando um modelo tem vários fornecedores, a lista completa está em providers no catálogo de preços.
name- Nome de exibição.
context_length- Janela de contexto em tokens. Apenas modelos de texto.
max_completion_tokens- Máximo de tokens de saída por requisição. Apenas modelos de texto.
architecture- input_modalities e output_modalities são os tipos de entrada e saída que o modelo suporta e são a referência; modality é um texto de exibição montado a partir deles.
pricing- Preços dos modelos de texto em USD por token, como strings decimais. prompt é a entrada, completion é a saída, e input_cache_read, input_cache_write e input_cache_write_1h são leituras e gravações de cache; itens que o modelo não suporta são omitidos.
supported_parameters- Recursos que o modelo comprovadamente suporta, como max_tokens e tools.
{
"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"]
}
]
}O exemplo mantém um só modelo e omite alguns campos.
- /models e /v1/models retornam o mesmo conteúdo.
- As respostas trazem um ETag. Envie If-None-Match e, se a lista não mudou, o retorno é 304, então fazer polling é barato.
- Um modelo temporariamente sem capacidade continua na lista; as chamadas a ele retornam 429 até que haja capacidade de novo.
Catálogo de preçoslink
Preços de todos os modelos que você pode chamar agora, em um único formato para texto, imagem e vídeo. Ao contrário da lista de modelos, retorna todos os tipos por padrão.
/v1/models/pricingcurl 'https://api.wokey.ai/v1/models/pricing?model=deepseek-v4.1-flash'
curl 'https://api.wokey.ai/v1/models/pricing?output_modalities=image,video'Parâmetros de consulta
output_modalities- Opcional. Mesmos valores da lista de modelos; o padrão é all.
model- Opcional. Retorna um único modelo, sem diferenciar maiúsculas e minúsculas. Um ID de modelo desconhecido retorna uma lista vazia.
Campos da resposta
owned_by / providers- owned_by é o fornecedor principal; providers lista os fornecedores habilitados no momento, na ordem de prioridade padrão, usando os IDs de fornecedor que o parâmetro de requisição provider aceita. O preço é o mesmo, seja qual for o fornecedor que atender a requisição.
pricing_skus- A lista de itens de preço, com o mesmo formato para todos os modelos.
pricing_skus[].meter- O que é cobrado. Modelos de texto usam input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cache_write_5m_tokens e cache_write_1h_tokens; imagens usam output_images; vídeos usam output_video.
pricing_skus[].unit / quantity- A unidade e a quantidade precificadas: por 1,000,000 de tokens para texto, por imagem e por segundo de vídeo.
pricing_skus[].price_usd- O preço da Wokey em USD, como string decimal.
reference_price_usd / savings_pct- Apenas modelos de texto: o preço oficial de referência e o desconto em relação a ele, em porcentagem.
pricing_skus[].constraints- Quando o preço se aplica, como uma faixa de tamanho de imagem, ou um modo, resolução e intervalo de duração de vídeo.
time_of_day- Apenas para modelos com preço por horário do dia. current_tier é o período atual (peak ou off_peak), peak_windows_utc lista os horários de pico em UTC e tiers traz os preços dos dois períodos. pricing_skus sempre mostram o período atual.
prompt_tiers- Apenas para modelos com preço por tamanho da entrada. Quando a entrada de uma requisição (incluindo leituras e gravações de cache) ultrapassa above_prompt_tokens, todos os itens cobrados usam os preços dessa faixa.
{
"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"
}
]
}
]
}O exemplo mantém um só modelo e omite alguns campos.
- Os preços podem mudar conforme o horário do dia e a oferta, por isso este endpoint nunca é armazenado em cache e sempre retorna os preços atuais.
Modelos de imagem e vídeolink
curl 'https://api.wokey.ai/v1/images/models'
curl 'https://api.wokey.ai/v1/videos/models'/v1/images/modelsRetorna os modelos de imagem que você pode chamar agora: endpoints suportados (geração, edições), parâmetros e seus valores permitidos (parameter_schema), suporte a streaming e edição, e o preço por imagem (pricing_skus). Uso: Geração de imagens →
/v1/videos/modelsRetorna os modelos de vídeo com pelo menos uma variante à venda: modos de geração, resoluções, proporções de tela, intervalo de duração, limites de referências multimodais e o preço por segundo de cada variante (pricing_skus). Uso: Geração de vídeo →