Exportar uso e custos
Use Custos de Geração de Listas Para carregar o que suas gerações custam ao longo de um intervalo de tempo, por exemplo, um diariamente puxar em um depósito de dados. 500 Por chamada, então um dia com 8,000 As gerações são 16 Pedidos.
Para o custo de uma única geração, use Obter Custos de Geração. Ambos os endpoints retornam o mesmo objeto de custo.
Solicitar um intervalo de tempo
Envie startTime e endTime como datas-hora ISO 8601 UTC. O intervalo filtra pelo momento em que uma geração concluiu. startTime é inclusivo e endTime é exclusivo.
Uma chave de API lista todas as gerações da organização, independentemente de qual chave ou membro do Studio as criou.
Leia todas as páginas
A resposta é { "items": [...], "nextCursor": "..." }. Solicite a próxima página com o mesmo startTime e endTime mais cursor, até que nextCursor seja null. Os itens estão ordenados do mais antigo para o mais recente.
Mantenha startTime e endTime ao consultar as páginas seguintes. O cursor retoma a consulta a partir de uma geração do intervalo. Alterar o intervalo entre páginas pode fazer com que alguns itens sejam ignorados. Se o cursor não corresponder a uma geração do intervalo solicitado, a API retorna 400, o que diferencia esse erro do fim dos resultados.
O que cada item contém
Os valores são strings decimais com cinco casas decimais. Analisá-los como decimais, não como flutuantes. Uma geração com dublagem ou com texto gerado tem um componente para cada parte.
Crie uma extração diária
- Use faixas consecutivas. Uma geração aparece exatamente em uma faixa, a faixa em que ela foi concluída. As faixas, como uma por dia UTC, nunca se sobrepõem e nunca deixam de incluir uma geração.
- Espere 10 minutos após o fim do intervalo. Os custos são normalmente registrados dentro de cerca de 10 minutos após a conclusão. Antes disso, um item pode ter
availability: "pending". Leia o intervalo novamente mais tarde para capturar as quantias registradas desde então. - Use
generationIdcomo chave para suas linhas. Ao ler uma faixa novamente, você recebe as mesmas gerações, então uma atualização de inserção garante que sua tabela esteja correta. - Trate
nullcomo desconhecido, não como zero.totalCostUsdénulla menos que todos os componentes do custo sejam conhecidos.knownSubtotalUsdé a parte conhecida. Veja disponibilidade. - Somente as gerações concluídas são listadas. Uma geração em progresso aparece na faixa em que ela é concluída.
Disponibilidade
availability diz quantas partes do custo de um item são conhecidas. Cada componente tem status e reason que explicam por que uma quantia está faltando.
Um componente pending geralmente recebe sua quantidade dentro de cerca de 10 minutos, mas um item não está garantido a se tornar complete. Itens partial e unavailable podem permanecer assim.
Nos planos de crédito, os valores são o valor nominal dos créditos da $0.01 cada, que pode diferir do preço pago em dinheiro por esses créditos.
Tratar erros
Todo pedido é uma leitura, então qualquer página pode ser reenviada.

