Referencia de la API/Modelos y precios

Modelos y precios

Usa estos endpoints para obtener los modelos que puedes llamar ahora, con su longitud de contexto, capacidades y precios, en lugar de mantener una tabla de modelos a mano.

Estos endpoints son públicos: no necesitan clave de API y solo devuelven los modelos que puedes llamar en este momento. Envía las solicitudes al host de la API, la misma URL base que usas para llamar a los modelos.

En esta páginaexpand_more

Lista de modelos
Catálogo de precios
Modelos de imagen y video

Lista de modeloslink

Una lista de modelos compatible con OpenAI. De forma predeterminada solo devuelve modelos de texto, así que los clientes que tratan cada entrada como un modelo de chat funcionan tal cual.

GET/v1/models

cURL

curl 'https://api.wokey.ai/v1/models'
curl 'https://api.wokey.ai/v1/models?output_modalities=all'

Parámetros de consulta

output_modalities: Opcional. Filtra por tipo de salida: text, image, video, all, o una combinación separada por comas como text,image. El valor predeterminado es text. Un valor no válido devuelve 400 invalid_output_modalities.

Campos de respuesta

id: El ID del modelo que se envía en model.
owned_by: El proveedor principal del modelo. Cuando un modelo tiene varios proveedores, la lista completa está en providers del catálogo de precios.
name: Nombre para mostrar.
context_length: Ventana de contexto en tokens. Solo modelos de texto.
max_completion_tokens: Máximo de tokens de salida por solicitud. Solo modelos de texto.
architecture: input_modalities y output_modalities son los tipos de entrada y salida que admite el modelo y son la referencia; modality es un texto descriptivo construido a partir de ellos.
pricing: Precios de los modelos de texto en USD por token, como cadenas decimales. prompt es la entrada, completion es la salida, e input_cache_read, input_cache_write e input_cache_write_1h son las lecturas y escrituras de caché; se omiten las entradas que el modelo no admite.
supported_parameters: Capacidades que el modelo admite de forma confirmada, como max_tokens y 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"]
    }
  ]
}

El ejemplo conserva un solo modelo y omite algunos campos.

/models y /v1/models devuelven el mismo contenido.
Las respuestas incluyen un ETag. Envía If-None-Match y, si la lista no cambió, se devuelve 304, así que consultar periódicamente es barato.
Un modelo que está temporalmente al máximo de capacidad sigue en la lista; las llamadas a él devuelven 429 hasta que se libere capacidad.

Catálogo de precioslink

Precios de todos los modelos que puedes llamar ahora, en un mismo formato para texto, imagen y video. A diferencia de la lista de modelos, devuelve todos los tipos de forma predeterminada.

GET/v1/models/pricing

cURL

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'

Parámetros de consulta

output_modalities: Opcional. Mismos valores que la lista de modelos; el valor predeterminado es all.
model: Opcional. Devuelve un solo modelo, sin distinguir mayúsculas y minúsculas. Un ID de modelo desconocido devuelve una lista vacía.

Campos de respuesta

owned_by / providers: owned_by es el proveedor principal; providers enumera los proveedores habilitados actualmente en el orden de prioridad predeterminado, con los ID de proveedor que acepta el parámetro de solicitud provider. El precio es el mismo sin importar qué proveedor atienda la solicitud.
pricing_skus: La lista de entradas de precio, con la misma forma para todos los modelos.
pricing_skus[].meter: Lo que se cobra. Los modelos de texto usan input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cache_write_5m_tokens y cache_write_1h_tokens; las imágenes usan output_images; los videos usan output_video.
pricing_skus[].unit / quantity: La unidad y la cantidad a las que se aplica el precio: por 1,000,000 de tokens para texto, por imagen y por segundo de video.
pricing_skus[].price_usd: El precio de Wokey en USD, como cadena decimal.
reference_price_usd / savings_pct: Solo modelos de texto: el precio oficial de referencia y el descuento respecto a él, en porcentaje.
pricing_skus[].constraints: Cuándo se aplica el precio, como un nivel de tamaño de imagen, o un modo, resolución y rango de duración de video.
time_of_day: Solo para modelos con precio según la hora del día. current_tier es el periodo actual (peak u off_peak), peak_windows_utc enumera las horas pico en UTC y tiers indica los precios de ambos periodos. pricing_skus siempre muestran el periodo actual.
prompt_tiers: Solo para modelos con precio según la longitud de la entrada. Cuando la entrada de una solicitud (incluidas lecturas y escrituras de caché) supera above_prompt_tokens, todos los conceptos de cobro usan los precios de ese nivel.

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"
        }
      ]
    }
  ]
}

El ejemplo conserva un solo modelo y omite algunos campos.

Los precios pueden cambiar según la hora del día y la oferta, por eso este endpoint nunca se almacena en caché y siempre devuelve los precios actuales.

Modelos de imagen y videolink

cURL

curl 'https://api.wokey.ai/v1/images/models'
curl 'https://api.wokey.ai/v1/videos/models'

GET/v1/images/models

Devuelve los modelos de imagen que puedes llamar ahora: endpoints admitidos (generación, ediciones), parámetros y sus valores permitidos (parameter_schema), compatibilidad con streaming y edición, y el precio por imagen (pricing_skus). Uso: Generación de imágenes →

GET/v1/videos/models

Devuelve los modelos de video con al menos una variante a la venta: modos de generación, resoluciones, relaciones de aspecto, rango de duración, límites de referencias multimodales y el precio por segundo de cada variante (pricing_skus). Uso: Generación de video →