Exporta el uso y los costes
Usa Enumerar los costes de generación para consultar cuánto costaron tus generaciones en un intervalo de tiempo, por ejemplo para importar los datos cada día a un almacén de datos. Devuelve un elemento por generación finalizada, con hasta 500 por llamada. Un día con 8,000 generaciones requiere 16 solicitudes.
Para consultar el coste de una sola generación, usa Obtener los costes de generación. Ambos endpoints devuelven el mismo objeto de coste.
Solicita un intervalo de tiempo
Envía startTime y endTime como fechas y horas UTC en formato ISO 8601. El intervalo filtra por el momento en que terminó la generación. startTime está incluido y endTime queda excluido.
Una clave de API enumera todas las generaciones de su organización, con independencia de la clave o del miembro de Studio que las creó.
Lee todas las páginas
La respuesta es { "items": [...], "nextCursor": "..." }. Solicita la página siguiente con los mismos valores de startTime y endTime y añade cursor. Repite hasta que nextCursor sea null. Los elementos se ordenan del más antiguo al más reciente.
Mantén startTime y endTime fijos al recorrer las páginas. El cursor continúa desde una generación del intervalo, así que cambiar el intervalo entre páginas puede omitir elementos. Si el cursor no corresponde a una generación del intervalo solicitado, se devuelve 400 para distinguir ese caso del fin de los datos.
Qué contiene cada elemento
Los importes son cadenas de números decimales con cinco cifras decimales. Interprétalos como valores decimales y evita usar números de coma flotante. Una generación con doblaje o voz generada tiene un componente por cada parte.
Configura una extracción diaria
- Usa intervalos consecutivos. Cada generación aparece en un solo intervalo, aquel en el que terminó. Los intervalos como los días UTC nunca se solapan ni omiten generaciones.
- Espera 10 minutos después de que termine el intervalo. Los costes suelen registrarse en unos 10 minutos desde que termina la generación. Hasta entonces, un elemento puede tener
availability: "pending". Vuelve a leer el intervalo más tarde para recoger los importes registrados desde la última lectura. - Usa
generationIdcomo clave de cada fila. Volver a leer un intervalo devuelve las mismas generaciones. Inserta las filas nuevas y actualiza las existentes para mantener la tabla al día. - Interpreta
nullcomo un valor desconocido, nunca como cero.totalCostUsdesnullsi se desconoce alguna parte del coste.knownSubtotalUsdes la parte conocida. Consulta Disponibilidad. - La lista solo incluye generaciones finalizadas. Una generación en curso aparece en el intervalo en el que termina.
Disponibilidad
availability indica qué parte del coste de un elemento se conoce. status y reason de cada componente indican por qué falta un importe.
Un componente pending suele recibir su importe en unos 10 minutos, aunque no hay garantía de que un elemento pase a complete. Los elementos partial y unavailable pueden conservar ese estado.
En los planes de créditos, los importes reflejan el valor nominal de $0.01 por crédito, que puede diferir del precio pagado por los créditos. Los importes excluyen impuestos, cuotas de suscripción, reembolsos, créditos de la cuenta y cargos de proveedores externos.
Gestiona los errores
Todas las solicitudes son de lectura, así que puedes volver a solicitar cualquier página con seguridad.

