Developer Platform · Beta

API de imagem, vídeo e tools

A mesma engine que roda o app Caranguejo, agora no seu código. Dezenas de modelos de imagem e vídeo, além de tools como upscale, relight e inpaint — via REST, SDK, CLI, servidor MCP e Skills para agentes.

Toda geração passa por um único endpoint assíncrono. Você envia um model (o slug de um modelo ou tool) mais o prompt e os parâmetros, recebe um job processing, e busca o resultado por polling ou webhook. A base de tudo é:

bash

# Gere uma imagem em uma linha
curl -X POST https://caranguejo.art/api/v1/dev/generations \
  -H "Authorization: Bearer $CK" -H "Content-Type: application/json" \
  -d '{ "model": "gpt-image-2", "prompt": "um caranguejo numa praia neon", "params": { "quality": "high" } }'

Comece pelo Quickstart para gerar sua primeira imagem em minutos.

Quatro formas de integrar

Do REST puro a agentes de IA — escolha a superfície que combina com você. Todas usam a mesma chave e os mesmos créditos.

API REST

Endpoints assíncronos com webhooks assinados, uploads e paginação por cursor.

/api/v1/dev · abrir

Servidor MCP

Conecte Claude, Cursor e outros agentes. Geração por tool-calling em segundos.

@caranguejo/mcp · abrir

CLI

Gere direto do terminal ou de scripts. --wait e --json inclusos.

@caranguejo/cli · abrir

Agent Skills

Playbooks prontos que falam direto com o servidor MCP — /caranguejo:generate.

caranguejo-skills · abrir

Tudo que você pode gerar

Uma lista viva de modelos e tools. Consulte Modelos ou GET /models para o catálogo completo e atualizado.

Imagem image

Texto→imagem, edição e referência (multi-imagem). Qualidade low/medium/high, até 4K, fundo transparente, múltiplos formatos.

Vídeo video

Texto→vídeo e imagem→vídeo com controle de duração, aspect ratio e frames inicial/final. Vários engines de ponta.

Tools tool

Pós-produção: upscale, relight, enhance e inpaint sobre imagem ou vídeo — sem prompt, só a mídia de entrada.

Todos os modelos usam o mesmo endpoint POST /generations: basta trocar model e os params. O consumo em créditos volta em credits_charged.