Desenvolvedores · API v1

Uma API.
Todos os modelos.

Imagens, vídeo, áudio e 3D numa só API, com o mesmo saldo do estúdio. Crie uma chave em Configurações e instale a CLI com npm.

Obter uma chave de APIInício rápido
Instalar a CLI
npm i -g ineveo
Modelos
699
Endpoints
9
Recarga mínima
€ 3
01 · Exemplos

A mesma chamada, qualquer resultado

Troque o ID do modelo para alternar entre imagem, vídeo e voz. Os campos seguem o modelo.

1# 1. Generate an image2curl -X POST https://ineveo.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $INEVEO_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://ineveo.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $INEVEO_API_KEY"17 18# 3. Download the file19curl https://ineveo.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $INEVEO_API_KEY" \21  -o result.jpeg
Render de exemploluma/uni-v1/text-to-image
[02] Início rápido

Seu primeiro render em três passos

  1. 01Crie uma chave de APIEntre com seu email, abra Configurações, Chaves de API e crie uma chave. Recarregue a partir de € 3 em Cobrança.export INEVEO_API_KEY="YOUR_API_KEY"
  2. 02Instale a CLIUm só comando: npm i -g ineveo. Ela lê sua chave de INEVEO_API_KEY.npm i -g ineveo
  3. 03Faça seu primeiro renderEscolha um ID de modelo no catálogo e envie um prompt. Adicione --dry-run para ver o preço sem gastar nada.ineveo run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
[03] CLI

Renderize pelo terminal

Execute qualquer modelo a partir de um shell, um job de CI ou um agente de código. Cada render tem o preço calculado antes de começar e é pago com o mesmo saldo.

Scripts e CICada campo de um modelo é uma flag; um arquivo local é enviado para você.
JSON no stdoutUm documento JSON por execução, progresso e erros no stderr, código de saída diferente de zero em caso de falha.
Agentes de códigoUm arquivo de skill ensina seu agente a verificar o preço primeiro e a limitá-lo.
Guia completo da CLI →
ComandoO que faz
ineveo models --type videoTodos os modelos de vídeo com o preço inicial
ineveo run <model> -hOs campos de um modelo, ao vivo: tipo, padrão, valores permitidos
ineveo run <model> -p "<prompt>" -o ./out/Renderiza e salva o resultado em uma pasta
ineveo run <model> -p "..." --dry-runO preço exato, sem gastar nada
ineveo run <model> -p "..." --max-price 0.50Não executa se o preço for maior
ineveo run <model> -p "..." --json -o ./out/Um resultado em JSON, pronto para o próximo passo
ineveo skill installEnsine seu agente de código a usar a CLI
[04] Essencial da API

Pronta para produção

Autenticação

Um token Bearer no cabeçalho Authorization. Crie chaves em Configurações e revogue qualquer uma a qualquer momento.

Authorization: Bearer YOUR_API_KEY

Renders em segundo plano

Iniciar um render responde na hora com o status queued. Consulte o render até que ele seja concluído, falhe ou seja reembolsado.

{ "status": "queued" }

Preço primeiro

Peça o preço exato dos seus parâmetros sem iniciar nada. Todos os valores estão em centavos de euro.

POST /api/v1/api/catalog/quote

Repetições seguras

Envie um cabeçalho Idempotency-Key e uma requisição repetida nunca cobra duas vezes.

Idempotency-Key: render-042

Limites

Cada chave tem um limite por minuto e um teto diário opcional. Acima do limite, a API responde 429.

429 Too Many Requests

Erros e reembolsos

Erros em JSON com um código e uma mensagem. Um render que falha é reembolsado no seu saldo automaticamente.

{ "status": "refunded" }
[05] Referência

Endpoints

URL base https://ineveo.com/api/v1

Referência completa da API →
GET/api/catalog/meSua chave e seu saldo
GET/api/catalog/modelsTodos os modelos
GET/api/catalog/models/detail?id=MODEL_IDUm modelo e seus campos
POST/api/catalog/quotePreço para entradas exatas
POST/api/catalog/generationsIniciar uma geração
GET/api/catalog/generationsSuas gerações recentes
GET/api/catalog/generations/IDStatus de uma geração
GET/api/catalog/generations/ID/contentO arquivo de resultado
DELETE/api/catalog/generations/IDExcluir uma geração

Recarregue € 3 e lance hoje

Crie uma chave de API em Configurações e chame qualquer modelo. A CLI está disponível no npm. Renders com falha são reembolsados.

Obter uma chave de APIVer preços