API de IAAPI

Escrita com IA, exposta do jeito que você realmente vai chamar

Um endpoint REST gera uma legenda a partir de um briefing. O resto do kit de escrita, reescrever um rascunho para cada rede e reaproveitar uma URL, fica no servidor MCP de FoPost, onde um cliente de IA pode encadear tudo direto no agendamento.

POST /v1/ai/generate-caption
curl -X POST https://api.fopost.com/v1/ai/generate-caption \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "instructions": "Announce webhook retries with exponential backoff. Keep it direct.",
    "platforms": ["linkedin"]
  }'

Um endpoint REST

generate-caption recebe um briefing e as plataformas de destino e retorna o texto pronto.

Três ferramentas MCP

generate_caption, rewrite_for_platforms e repurpose_url para qualquer cliente MCP.

Baseado em créditos

Cada chamada consome os créditos de IA do espaço de trabalho. Consulte o saldo a qualquer momento.

REST

Gere uma legenda a partir do seu próprio pipeline

Envie um briefing curto e a rede de destino e receba uma legenda escrita dentro dos limites dessa rede. A chave precisa do escopo ai. A resposta é texto; nada é publicado até você passá-lo para POST /v1/posts.

Ler a referência de IA
Resposta
{
  "caption": "Webhook retries are live. A failed delivery now retries with exponential backoff before it ever reaches your inbox as an error. Details in the changelog.",
  "credits": { "charged": 1, "remaining": 199 }
}

Adaptado à plataforma

Tamanho, uso de hashtags e quebras de linha seguem a rede que você indicar.

Nunca publica sozinho

O endpoint retorna texto. A publicação é uma solicitação separada e explícita.

Escopo ai

Conceda apenas às chaves que devem gastar créditos.

MCP

Reescreva e reaproveite a partir de um cliente de IA

O servidor MCP expõe o conjunto completo de escrita. rewrite_for_platforms transforma um rascunho em uma thread para o X e um parágrafo para o LinkedIn. repurpose_url lê uma página e propõe uma série de posts. Ambos entregam o resultado para schedule_post na mesma sessão, com o cliente pedindo confirmação antes de qualquer publicação.

Configurar o servidor MCP
Prompt
> Take our latest changelog at https://yourbrand.com/changelog
  and turn it into three posts for LinkedIn and X this week.

Agent: I'll call repurpose_url, then rewrite_for_platforms for each,
then schedule_post for Tue, Wed, and Thu at 9am. Proceed? (y/n)

rewrite_for_platforms

Entra um rascunho, sai uma versão por rede, cada uma dentro dos seus limites.

repurpose_url

Aponte para um post, um changelog ou uma página de documentação e receba uma série de volta.

Direto para o agendamento

O agente encadeia as ferramentas de escrita em schedule_post sem sair do chat.

Créditos

Gastos visíveis, limitados e por espaço de trabalho

Cada chamada de IA é medida contra o crédito mensal gratuito de uso incluído em todas as contas. Consulte o saldo via MCP com get_ai_credits e no painel em AI Usage. Quando o saldo acaba, a chamada retorna 402 com um link de upgrade em vez de falhar silenciosamente.

Comece a construir
O agente rascunhando posts para várias redes com uma voz da marca salva

get_ai_credits

Pergunte ao agente quantos créditos restam antes de um lote grande.

402 claro

Saldo esgotado é um erro explícito, nunca um post escrito pela metade.

Restrito ao espaço de trabalho

Créditos e prompts ficam dentro do espaço de trabalho ao qual a chave pertence.

Perguntas sobre API de IA, respondidas

Quais recursos de IA estão na API REST?

Um endpoint: POST /v1/ai/generate-caption, com o escopo ai. A reescrita por rede, as sugestões de hashtags e o reaproveitamento de URLs estão disponíveis como ferramentas MCP e no agente do aplicativo, não como endpoints REST públicos hoje.

Qual modelo ele usa?

FoPost não expõe o provedor nem o modelo. Você escolhe um recurso e um tom; o serviço decide o que executa e pode mudar isso sem nenhuma alteração do seu lado.

Ele publica sozinho?

Não. Todo endpoint e ferramenta de IA retorna texto. A publicação é uma solicitação separada, e os clientes MCP mostram a chamada schedule_post para aprovação antes de executá-la.

Como os créditos são cobrados?

Cada chamada é medida na sua conta de cobrança e informada na resposta. O uso consome primeiro o crédito mensal gratuito; com um cartão cadastrado, o que passar disso é cobrado exatamente pelo que você usar.

Ele conhece a voz da minha marca?

Chamadas feitas pelo agente do aplicativo podem anexar uma marca, que incorpora sua voz e estilo ao prompt. O endpoint REST recebe um brand_voice_id, ou usa a marca padrão do espaço de trabalho, além do briefing que você enviar.

De qual escopo a chave precisa?

O escopo ai. Uma chave sem ele recebe 403 neste endpoint, mas continua funcionando para os outros escopos que tiver.

Comece a construir com API de IA hoje

Começar é grátis e a API completa está incluída. Crie uma chave e faça sua primeira chamada em minutos.

Obtenha sua chave de API