Preços

Cada modelo custa exatamente o que o respetivo criador cobra, em dólares americanos. Paga a partir do seu saldo da API, contabilizado em créditos de API: 1000 créditos da API = 1 $. O saldo da API é independente do saldo das aplicações Doitong. Não existem planos, mínimos nem taxas por modelo: uma chamada custa o respetivo preço, debitado do saldo da API quando o pedido é aceite.

Na Rússia (doitong.ru, api.doitong.ru ou ?currency=rub), os preços também são apresentados em rublos: preço em USD × taxa USD/RUB × 1,3.

Unidades#

Cada modelo tem uma unidade de faturação, apresentada na respetiva página e em GET https://api.doitong.com/v1/models/{model_id}:

Preço = quantidade × créditos de API por unidade, arredondado por excesso para um crédito de API inteiro (0,001 $), nunca inferior a 1. Unidades muito baratas podem ter um preço fracionário por unidade (0.4 créditos de API por segundo); apenas o total da chamada é arredondado.

Alguns modelos aplicam uma tarifa diferente consoante a entrada: vídeo com som custa mais do que sem som, 4K custa mais do que 1K, etc. Estas regras estão indicadas na página de cada modelo. Um parâmetro omitido conta como o seu valor por predefinição, pelo que o preço apresentado para uma entrada é o preço que paga.

Preços exatos, medidos, estimados e por utilização#

Cada preço tem um mode:

• exact: o preço é calculado a partir da sua entrada (segundos, imagens, megapixels, caracteres, passos ou um preço fixo por vídeo ou chamada).
• measured: o preço segue os ficheiros enviados: a duração de um vídeo ou áudio de entrada, o tamanho de uma imagem de entrada, a taxa de frames ou o número de frames de um vídeo. Antes da execução, a API lê a duração, a resolução e a taxa de frames do ficheiro (o orçamento faz o mesmo), pelo que o orçamento corresponde exatamente ao que a execução cobra. A página do modelo indica o que paga ("Preço por segundo do seu vídeo de entrada") e a calculadora usa os valores do ficheiro. Um ficheiro que não possa ser lido é recusado com unmeasurable_input e nada é cobrado.
• estimate: o custo do modelo depende de algo que a entrada não permite saber antecipadamente (tokens, tempo de computação). Esse modelo cobra um preço estimado fixo por execução (por imagem de saída quando tem uma contagem de imagens), definido pelo custo médio das execuções reais desse modelo. Continua a saber o preço antes de executar: o orçamento é o que paga.
• metered: o modelo é cobrado pela utilização real, que só a própria execução conhece: os tokens lidos e escritos por um modelo de linguagem ou visão, os segundos de fala gerados por um modelo de voz ou o tempo de processamento do modelo. Consulte Cobrança por utilização abaixo.

As páginas dos modelos indicam "Preço por execução", "Preço por segundo do seu vídeo de entrada" e semelhantes, "Preço estimado por execução" ou "Cobrança por utilização"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate e ?mode=metered apresenta-os.

Cobrança por utilização#

Um modelo metered tem um preço de utilização ("$0.01 por 1000 tokens", "$0.002 por segundo de áudio gerado", "$0.00111 por segundo de tempo de processamento") e um máximo por execução: o custo máximo da execução, com base no que o seu pedido indica (max_tokens, a duração do texto, a resolução, o número de saídas) e nos limites publicados pelo modelo. Nunca depende do conteúdo de um ficheiro por detrás de um URL. Para um modelo faturado pelo tempo de processamento ou pela duração de uma sessão de voz, o máximo é a duração máxima de um pedido (15 minutos para imagens, 30 para áudio, 60 para vídeo), muito acima de uma execução normal. Uma entrada cujo máximo excedesse o limite por execução do modelo (um texto muito longo) é recusada com 422 invalid_input:

1. O orçamento devolve esse máximo como credits (com hold e typical, uma execução habitual). Quando a execução começa, o máximo é debitado do saldo da API e é esse valor que o saldo e o orçamento da chave têm de cobrir.
2. Quando a execução é bem-sucedida, o pedido é liquidado pela utilização indicada pelo modelo: utilização × preço de utilização, arredondado por excesso para um crédito de API inteiro. O restante do máximo é reembolsado automaticamente, uma vez, como uma linha refund do saldo da API.
3. Uma execução nunca custa mais do que o seu máximo. Uma execução falhada ou cancelada é totalmente reembolsada, como sempre.

A maioria das execuções custa muito menos do que o máximo; a página do modelo mostra "Até $X por execução" para a entrada do construtor e a execução habitual ("a partir de" no catálogo). Nos poucos modelos faturados pelo tempo de processamento, a utilização é o tempo de processamento do modelo (marcado como approximate).

{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}

Depois da execução, o cost do pedido mostra o que foi retido e o valor da utilização:

{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}

charged − refunded é o custo da execução. settled.status é pending durante o intervalo entre o resultado e a liquidação, e no_usage no caso raro de o modelo não indicar qualquer utilização (nesse caso, o máximo mantém-se como preço).

Obter um orçamento antes de executar#

POST https://api.doitong.com/v1/quote/{model_id} recebe exatamente o corpo que enviaria para run e devolve o preço dessa entrada: o preço exato, exceto para um modelo cobrado por utilização, em que é o custo máximo da execução. Não precisa de chave e não tem custos:

curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'

{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}

Com uma chave, o orçamento também devolve balance_credits e balance_usd (o seu saldo da API), affordable e key_budget_remaining. Adicione ?currency=rub para obter um valor em rub.

Objetos de preço#

Todos os preços na API têm a mesma estrutura:

• modelos: price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second", "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" } — além de rub, rub_display e from_rub na Rússia ou com ?currency=rub;
• pedidos: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (créditos de API; um pedido metered adiciona mode, held, typical e settled, consulte Cobrança por utilização);
• conta: GET https://api.doitong.com/v1/account devolve credits (o saldo da API), balance: { "credits", "usd" } e storage (preço, utilização e estimativa mensal do armazenamento de ficheiros).

Reembolsos#

• Um pedido inválido (qualquer 4xx antes do início da execução) nunca é cobrado.
• Um pedido que termine failed (incluindo timeout) é totalmente reembolsado no saldo da API, automaticamente.
• Um pedido que cancele antes de começar é totalmente reembolsado. Depois de o modelo começar a gerar, o cancelamento é apenas um pedido: se o modelo terminar, o resultado é entregue e cobrado.
• Um pedido metered bem-sucedido recebe de volta a parte do máximo que não utilizou.

O objeto do pedido mostra tudo: cost.credits, cost.charged e cost.refunded.

Armazenamento de ficheiros#

Os ficheiros de saída são mantidos no nosso armazenamento. Escolha na conta ou por execução (?storage=):

O armazenamento permanente é cobrado uma vez por dia a partir do saldo da API: GB mantidos × preço mensal ÷ dias do mês, como linhas do livro-razão do tipo storage. As frações de um crédito de API transitam para o dia seguinte, pelo que um mês totaliza exatamente GB × 100 créditos de API (1 GB = 1024³ bytes; 10 GB mantidos durante um mês custam 1000 créditos de API). O saldo nunca fica abaixo de zero: quando não for possível pagar, esse dia não é cobrado, recebe um e-mail e tem 30 dias para fazer um carregamento antes de os ficheiros mantidos se tornarem temporários e serem eliminados 7 dias depois. Detalhes: Ficheiros.

Preços atuais#

Estes são os modelos em destaque. Todos os 1496 modelos e os respetivos preços estão no catálogo de modelos e em GET /models (não é necessária uma chave).

Fazer um carregamento#

Adicione dinheiro ao saldo da API em https://doitong.com/developers/dashboard#balance. Quando o saldo é demasiado baixo, uma execução responde 402 insufficient_credits com um top_up_url. Cada chave de API também pode ter o seu próprio orçamento em créditos de API (consulte Autenticação).