View a markdown version of this page

Crédito alternativo por solicitudes rechazadas (beta) - Amazon Bedrock
Modelos compatiblesFuncionamientoReglas de canjeGestión de erroresImpacto en la facturaciónEjemplo de flujo de trabajo

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Crédito alternativo por solicitudes rechazadas (beta)

Cuando Claude Fable 5 rechaza una solicitud, los clientes que vuelven a intentar la misma conversación con un modelo diferente (por ejemplo, el Claude Opus 4,8) normalmente pagan las tasas de escritura en caché correspondientes al prefijo de conversación que ya estaba almacenado en caché en Fable 5. El crédito alternativo elimina este doble cargo al emitir una ficha de crédito única en caso de rechazo que se puede canjear al volver a intentarlo.

Esta función requiere que el indicador beta aparezca fallback-credit-2026-06-09 en la anthropic_beta matriz tanto en la solicitud original como en el reintento.

Modelos compatibles

Rol Model
Fuente (emite crédito en caso de rechazo) Claude Fable 5
Target (canjea el crédito al volver a intentarlo) Debe ser un destino alternativo válido del modelo de origen

Funcionamiento

Paso 1: Reciba un token de crédito alternativo en caso de rechazo

Cuando recibas una solicitud a Claude Fable 5 stop_reason: "refusal" y aparezca el indicador de la beta, el stop_details objeto incluye: fallback_credit_token

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "model": "anthropic.claude-fable-5",
  "content": [],
  "stop_reason": "refusal",
  "stop_details": {
    "type": "refusal",
    "category": "cyber",
    "explanation": "This request triggered restrictions on violative cyber content and was blocked under Anthropic's Usage Policy.",
    "fallback_credit_token": "<opaque token>"
  },
  "usage": {
    "input_tokens": 106,
    "output_tokens": 1
  }
}

fallback_credit_tokenEs una cadena opaca. Se produce null cuando no se cumplen las mejores condiciones (en la solicitud original no se leyó ningún caché, el modelo no es apto para obtener créditos o no aparece el indicador beta). Server-side los fallos de acuñación producennull, nunca un error.

En el modo streaming, el token se entrega en el message_delta evento final. stop_details

Paso 2: canjea el token en una solicitud de reintento

Pase el token como parámetro de nivel superior en el reintento al modelo alternativo:

{
  "anthropic_version": "bedrock-2023-05-31",
  "anthropic_beta": ["fallback-credit-2026-06-09"],
  "model": "anthropic.claude-opus-4-8",
  "max_tokens": 4096,
  "system": "...",
  "messages": [...],
  "tools": [...],
  "fallback_credit_token": "<token from the refusal's stop_details>"
}

Reglas de canje

Regla Requisito
Ventana de tiempo El token debe canjearse en un plazo de 5 minutos a partir de su emisión.
Vinculación de plataforma Una ficha acuñada solo se bedrock-mantle puede canjear el. bedrock-mantle
Body Match Los tools campos systemmessages, y deben coincidir exactamente con la solicitud rechazada. Envíelos tal como están; no elimine los bloques de pensamiento.
Vuelva a intentar las formas El cuerpo del reintento debe (a) coincidir exactamente con la solicitud rechazada (el modelo alternativo regenera la respuesta) o (b) compararla con un mensaje auxiliar adjunto que contenga la salida parcial de la respuesta rechazada (el modelo alternativo continúa desde donde se interrumpió Fable 5).
Modelo objetivo Debe ser un objetivo alternativo válido del modelo rechazado.

Gestión de errores

Con el indicador beta presente, cualquier error en la validación del canje devuelve un400 invalid_request_error. La ruta de recuperación en todos los casos es volver a intentarlo sinfallback_credit_token. Las condiciones de fallo incluyen:

  • El token está mal formado o es irreconocible

  • El token tiene más de 5 minutos

  • El cuerpo de la solicitud no coincide con la solicitud rechazada original

  • El modelo objetivo no es un objetivo alternativo válido

  • El token ya se ha canjeado

Sin el indicador beta, fallback_credit_token se rechaza como campo desconocido (400). El parámetro también se rechaza en count_tokens las solicitudes.

Impacto en la facturación

Cuando un token de crédito alternativo se canjea correctamente, la solicitud de reintento recibe un crédito por los tokens de escritura en caché que se superpongan con el prefijo almacenado en caché de la solicitud rechazada. El cliente solo paga por los nuevos tokens netos del reintento, no por volver a almacenar en caché el prefijo de la conversación.

Ejemplo de flujo de trabajo

  1. Envía una solicitud a Claude Fable 5 con. anthropic_beta: ["fallback-credit-2026-06-09"]

  2. Recibe un rechazo con un fallback_credit_token pinstop_details.

  3. Vuelva a intentarlo inmediatamente a Claude Opus 4.8 con el mismo systemmessages, ytools, más elfallback_credit_token.

  4. El reintento se factura a tasas reducidas para el prefijo en caché superpuesto.

Si el token está caducado o no es null válido, vuelve a intentarlo normalmente sin él. El crédito es una optimización de costes, no un requisito funcional para que el reintento se realice correctamente.