HomeSupportStudio
Direct API

Limites

Os limites de taxa de solicitações da Direct API, os cabeçalhos que os informam e os limites de tamanho e de quantidade.

Taxa de solicitações

CotaLimiteContado por
Leituras de gerações30 por minuto por geração, 1.200 por minuto no totalchave de API
Chamadas de ferramentas gratuitas (listas, catálogo, plan_media e cada URL de mídia que uma chamada importa)1.000 por horachave de API
Gerenciamento de webhooks (/webhooks e seus caminhos)60 por minutochave de API
/usage, /me60 por minutochave de API
Requisições cuja chave de API não funciona (401)60 a cada 10 minutos; acima disso, as requisições desse endereço recebem 429 (com Retry-After) até a janela se esgotar, exceto com uma chave que se autenticou nos últimos 10 minutosendereço IP do cliente (um endereço IPv6 pelo seu /64)
Chamadas de ferramentas pagassem limite de taxa de solicitações
  • As chamadas pagas são limitadas por dinheiro, não por taxa: os limites de créditos da sua chave e o saldo da sua organização.
  • Sob carga alta, uma geração aguarda em queued por capacidade do modelo em vez de ser recusada. Iniciar mais trabalho do que um modelo consegue executar de uma vez faz as gerações seguintes demorarem mais, nunca falharem.
  • Uma chamada paga cujo resultado acabou saindo gratuito, como video_remove_audio em um vídeo sem som, conta na cota de chamadas gratuitas.

Respostas de limite de taxa

Todo endpoint com limite de taxa retorna estes cabeçalhos:

X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 1187
X-RateLimit-Reset: 1792919760

Uma solicitação recusada responde 429 com Retry-After: <seconds> e este corpo:

{
  "description": "This API key read generations more than 1200 times a minute. Poll less often, or pass ?wait= to be answered when a status changes.",
  "code": "rate_limited",
  "data": { "retry_after_seconds": 14 }
}

Espere Retry-After segundos antes de tentar de novo. Um 429 nunca é cobrado.

Limites de tamanho e de quantidade

LimiteValor
Corpo da solicitação1 MB
variations por início de imagemde 1 a 4
IDs por leitura em lote10
wait45 s
metadata20 chaves; chave com até 40 caracteres, valor com até 500
Idempotency-Keyaté 200 caracteres, lembrado por 24 h
Chaves de API ativas por organização10
Endpoints de webhook por organização10
Validade dos links de recursosnão expiram
Entradas por modelo (tamanho do prompt, imagens de referência, durações, tamanhos de arquivo)conforme listado em Modelos e no input_schema de cada ferramenta

Se você tiver algum problema ou alguma dúvida, entre em contato. Teremos prazer em ajudar. Escreva para nós em support@morphic.com.

Erros

Todos os códigos de erro da Direct API, o que significam e se vale tentar de novo, incluindo o que fazer quando uma chamada paga falha com um 5xx.

Catálogo de ferramentas

Descubra as ferramentas da Direct API e seus JSON Schemas, e veja todas as ferramentas da v1 com o escopo de que cada uma precisa.

Nesta página

Taxa de solicitaçõesRespostas de limite de taxaLimites de tamanho e de quantidade