Preços

Cada modelo custa exatamente o que seu criador cobra por ele, em dólares americanos. Você paga usando seu saldo da API, que é contabilizado em créditos de API: 1.000 créditos de API = $ 1. O saldo da API é próprio e separado dos créditos dos aplicativos Doitong. Não há planos, mínimos ou taxas por modelo: uma chamada custa seu preço, debitado do saldo da API quando a requisição é aceita.

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

Unidades#

Cada modelo tem uma unidade de cobrança, exibida na página dele e em GET https://api.doitong.com/v1/models/{model_id}:

Preço = quantidade × créditos de API por unidade, arredondado para cima até um crédito de API inteiro ($ 0,001), nunca menos que 1. Unidades muito baratas podem ter um preço fracionário por unidade (0.4 créditos de API por segundo); somente o total de uma chamada é arredondado.

Alguns modelos cobram uma tarifa diferente dependendo da entrada: vídeo com som custa mais que sem som, 4K custa mais que 1K e assim por diante. Essas regras são listadas na página de cada modelo. Um parâmetro que você omite conta como seu valor padrão, portanto o preço exibido para uma entrada é o preço que você paga.

Preços exatos, medidos, estimados e por uso#

Todo preço tem um mode:

• exact: o preço é calculado a partir da sua entrada (segundos, imagens, megapixels, caracteres, etapas ou um preço fixo por vídeo ou chamada).
• measured: o preço segue os arquivos enviados: a duração de um vídeo ou áudio de entrada, o tamanho de uma imagem de entrada, a taxa de quadros ou a quantidade de quadros de um vídeo. Upscalers, sincronização labial, vídeo para vídeo, transcrição e ferramentas de áudio são cobrados dessa forma. Antes da execução, a API lê a duração, a resolução e a taxa de quadros do arquivo (a cotação faz o mesmo), portanto a cotação é exatamente o que a execução cobra. A página do modelo informa pelo que você paga ("Preço por segundo do seu vídeo de entrada") e a calculadora usa os números do seu arquivo. Um arquivo que não pode ser lido é recusado com unmeasurable_input e nada é cobrado.
• estimate: o custo do próprio modelo depende de algo que a entrada não pode informar antecipadamente (tokens, tempo de processamento). Esse modelo cobra um preço estimado fixo por execução (por imagem de saída quando há uma quantidade de imagens), definido a partir do custo médio de execuções reais desse modelo. Você ainda sabe o preço antes de executar: a cotação é o que você paga.
• metered: o modelo é cobrado pelo uso real, que somente a própria execução conhece: os tokens que um modelo de linguagem ou visão lê e escreve, os segundos de fala que um modelo de voz gera ou o tempo de processamento do modelo. Consulte Cobrança por uso abaixo.

As páginas dos modelos informam "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 uso"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate e ?mode=metered os lista.

Cobrança por uso#

Um modelo metered tem um preço por uso ("$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 maior valor que a execução pode custar, com base no que sua requisição informa (max_tokens, o comprimento do seu texto, a resolução, a quantidade de saídas) e nos limites publicados do modelo. Isso nunca depende do conteúdo de um arquivo atrás de uma URL. Para um modelo cobrado pelo tempo de processamento ou pela duração de uma sessão de voz, o máximo é o maior tempo que uma requisição pode durar (15 minutos para imagens, 30 para áudio, 60 para vídeo), portanto fica muito acima de uma execução típica. Uma entrada cujo máximo ultrapassaria o limite por execução do modelo (um texto muito longo) é recusada com 422 invalid_input:

1. A cotação retorna esse máximo como credits (com hold e typical, uma execução usual). Quando a execução começa, o máximo é debitado do saldo da API, e é esse valor que o saldo e o limite da sua chave precisam cobrir.
2. Quando a execução é bem-sucedida, a requisição é ajustada ao uso informado pelo modelo: uso × preço por uso, arredondado para cima até um crédito de API inteiro. O restante do máximo recebe reembolso automaticamente, uma vez, como uma linha refund do seu saldo da API.
3. Uma execução nunca custa mais que seu máximo, mesmo que seu uso pudesse ultrapassá-lo. Uma execução que falha ou é cancelada recebe reembolso integral, como sempre.

A maioria das execuções custa muito menos que o máximo; a página do modelo mostra "Até $X por execução" para a entrada do criador e a execução típica ("a partir de" no catálogo). Para os poucos modelos cobrados pelo tempo de processamento, o uso é 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 da requisição mostra o que foi retido e o valor correspondente ao uso:

{
  "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 o ajuste, e no_usage no caso raro de o modelo não informar nenhum uso (nesse caso, o máximo permanece como preço).

Consulte o preço antes de executar#

POST https://api.doitong.com/v1/quote/{model_id} recebe exatamente o corpo que você enviaria para run e retorna o preço dessa entrada: o preço exato, exceto para um modelo cobrado por uso, no qual é o máximo que a execução pode custar. Não precisa de chave e não custa nada:

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, a cotação também retorna balance_credits e balance_usd (seu saldo da API), affordable e key_budget_remaining. Adicione ?currency=rub para um valor em rub.

Objetos de preço#

Todo preço na API tem o mesmo formato:

• models: 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;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (créditos de API; uma requisição metered adiciona mode, held, typical e settled, consulte Cobrança por uso);
• account: GET https://api.doitong.com/v1/account retorna credits (o saldo da API), balance: { "credits", "usd" } e storage (preço, uso e estimativa mensal do armazenamento de arquivos).

Reembolsos#

• Uma requisição inválida (qualquer 4xx antes do início da execução) nunca é cobrada.
• Uma requisição que termina como failed (incluindo timeout) recebe reembolso integral no saldo da API, automaticamente.
• Uma requisição que você cancela antes do início recebe reembolso integral. Depois que o modelo começa a gerar, o cancelamento é apenas uma solicitação: se o modelo terminar, o resultado será entregue e cobrado.
• Uma requisição metered bem-sucedida recebe de volta a parte do máximo que não utilizou.

O objeto da requisição mostra tudo: cost.credits, cost.charged e cost.refunded.

Armazenamento de arquivos#

Os arquivos de saída são mantidos no nosso armazenamento. Você escolhe, na conta ou por execução (?storage=):

O armazenamento permanente é cobrado uma vez por dia do saldo da API: GB mantidos × preço mensal ÷ dias do mês, como linhas do razão de tipo storage. Frações de um crédito de API são transportadas para o dia seguinte, portanto um mês totaliza exatamente GB × 100 créditos de API (1 GB = 1024³ bytes; 10 GB mantidos por um mês custam 1.000 créditos de API). O saldo nunca fica abaixo de zero: quando não puder pagar, esse dia não será cobrado, você receberá um e-mail e terá 30 dias para fazer uma recarga antes que os arquivos mantidos se tornem temporários e sejam excluídos 7 dias depois. Detalhes: Arquivos.

Preços atuais#

Estes são os modelos em destaque. Todos os 1.496 modelos e seus preços estão no catálogo de modelos e em GET /models (nenhuma chave necessária).

Fazer uma recarga#

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