Controles de enrutamiento por solicitud
Configura el límite respecto al precio oficial, los reintentos y el tiempo total de una generación de texto con encabezados HTTP opcionales.
Controles de enrutamiento por solicitud
Incluir o excluir canales
Define los canales para una solicitud de texto, imagen o vídeo. Puedes usar ambos encabezados. Las exclusiones tienen prioridad.
X-APIMaster-Include-Channels· Permite solo los canales de la lista.X-APIMaster-Exclude-Channels· Excluye los canales de la lista.
Cada encabezado admite hasta 64 enteros positivos separados por comas. Consulta los valores públicos de channel_id del modelo. La clave API y las preferencias de la consola determinan qué canales están disponibles. El canal también debe admitir la operación y los parámetros de tu solicitud.
curl "https://apimaster.ai/api/public/marketplace?model=deepseek-flash"
Todos los reintentos respetan estas reglas. La generación asíncrona las conserva y los endpoints con envío idempotente las incluyen en su comprobación.
Los encabezados inválidos devuelven 400 invalid_routing_parameter. Si no hay un canal compatible, la API devuelve 503 no_provider_within_channel_scope. Las consultas y descargas usan el canal de la tarea.
Omite estos encabezados al consultar o descargar un resultado. Los endpoints no compatibles y el grupo administrado FreeModel devuelven 400 routing_controls_unsupported.
Ejemplos de generación
curl "https://apimaster.ai/v1/chat/completions" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Exclude-Channels: $TEXT_CHANNEL_ID" \
-d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Reply with OK."}]}'
curl "https://apimaster.ai/v1/images/generations/async" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Include-Channels: $IMAGE_CHANNEL_ID" \
-d '{"model":"gpt-image-2","prompt":"A blue ceramic cup on a white table","size":"1024x1024"}'
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Include-Channels: $VIDEO_CHANNEL_ID" \
-d '{"model":"wan3.0-video-prime","prompt":"A flower sways in a light breeze","duration":2,"resolution":"480P"}'
Precio, reintentos y plazos para texto
Configura el límite respecto al precio oficial, los reintentos y el tiempo total de una generación de texto con encabezados HTTP opcionales.
| Encabezado | Comportamiento |
|---|---|
X-APIMaster-Max-Official-Price-Ratio |
Proporción máxima del precio oficial como número positivo. 0.5 admite hasta la mitad del precio oficial y 1 hasta el precio oficial completo. |
X-APIMaster-Max-Retries |
Número máximo de intentos adicionales tras el primero, como entero no negativo. 0 permite un solo intento. Se incluyen los cambios de proveedor y el recurso al proveedor oficial. |
X-APIMaster-Timeout-Ms |
Tiempo total en milisegundos como entero positivo desde la recepción en la puerta de enlace. Incluye el enrutamiento, los reintentos y la transmisión. Se aplica el límite de tiempo más corto. |
Cada encabezado es independiente. Los ajustes omitidos siguen la política actual y se respetan las preferencias de proveedores de la consola. El tope se aplica a los precios unitarios de entrada, salida y caché aplicable. El coste total depende del uso. Una vez transmitido contenido, no se reinicia la generación en otro proveedor.
Endpoints compatibles
POST /v1/chat/completionsPOST /v1/responsesPOST /v1/messagesPOST /v1beta/models/{model}:generateContentPOST /v1beta/models/{model}:streamGenerateContent
Estos controles se aplican a la generación de texto. Los endpoints de imagen, vídeo y otros no compatibles devuelven 400 routing_controls_unsupported si reciben estos encabezados. Los cargos separados, como las llamadas a herramientas, quedan fuera del tope de texto.
Ejemplo
curl https://apimaster.ai/v1/chat/completions \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Max-Official-Price-Ratio: 0.5" \
-H "X-APIMaster-Max-Retries: 1" \
-H "X-APIMaster-Timeout-Ms: 30000" \
-d '{"model":"gpt-6.2-sol","messages":[{"role":"user","content":"Reply with OK."}]}'
Errores
Los valores no válidos devuelven 400 invalid_routing_parameter. Si falta el precio oficial, se devuelve 400 official_price_unavailable. Si ningún proveedor cumple el tope, se devuelve 503 no_provider_within_price_limit antes del envío. Al vencer el plazo se devuelve 504 request_deadline_exceeded antes de empezar la respuesta o se termina la transmisión en curso.
