---
title: Início rápido | RunAPI
description: Chame modelos de linguagem do RunAPI por meio de um protocolo síncrono
  ou de streaming compatível.
url: https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart.md
canonical: https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart
locale: pt-BR
---

> Versão HTML: https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart
> Índice do site para agentes: https://runapi.ai/llms.txt

# Início rápido

O RunAPI expõe modelos de linguagem por meio de formatos de protocolo públicos familiares.
Aponte um cliente compatível existente para `https://runapi.ai`, use um
identificador de modelo RunAPI e autentique-se com uma Chave de API padrão.

## Escolher um protocolo

* Chat Completions compatível com OpenAI usa `POST /v1/chat/completions`.
* Responses compatível com OpenAI usa `POST /v1/responses`.
* Messages compatível com Anthropic usa `POST /v1/messages`.
* Geração de conteúdo compatível com Gemini usa
  `/v1beta/models/{model}:generateContent` ou `:streamGenerateContent`.

Escolha o protocolo que melhor se adapta ao seu cliente e fluxo de
aplicação existentes. O catálogo de modelos indica quais protocolos públicos
cada modelo suporta.

## Enviar uma requisição

Esta requisição de Chat Completions retorna uma resposta síncrona:

```shell
curl "https://runapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "Summarize why idempotency matters."}]
  }'
```

Mantenha a requisição e a resposta no formato de protocolo selecionado. Use a Referência da API da operação para campos exatos, chamada de ferramentas, saída estruturada e restrições específicas do modelo.

## Saída em streaming

Defina a opção de streaming do protocolo e consuma os server-sent events
retornados de forma incremental. Para Chat Completions, adicione `"stream": true`; para
chamadas compatíveis com Gemini, use a operação `:streamGenerateContent`.
Feche o stream quando seu cliente receber o evento terminal do protocolo.

## Inspecionar fidelidade de entrega

Toda resposta LLM aceita inclui `X-RunAPI-Fidelity`. Um valor de
`full` significa que a requisição foi entregue sem omissão. Um valor de
`lossy` significa que o RunAPI omitiu controles opcionais para completar a requisição;
`X-RunAPI-Omitted-Fields` contém seus nomes de campo separados por vírgula.
Requisições cujos ciclos de vida obrigatórios, continuação, ferramenta ou semântica de item tipado não puderem ser preservados são rejeitadas antes da criação de uma Task.

Ambos os cabeçalhos são expostos via CORS, de modo que clientes de navegador podem inspecioná-los.
Registre-os junto ao identificador da requisição quando o comportamento exato de entrega for
importante para a aplicação.

## Tratar erros e uso

Trate `401` como falha de Autenticação, respostas `4xx` como problemas de requisição ou de política, e tente novamente apenas falhas transitórias de servidor ou de rede. Leia o uso de tokens da resposta final ou do evento de stream terminal no formato de protocolo selecionado, e mantenha os identificadores de requisição nos logs da aplicação para suporte.

---

## Mais de RunAPI

- [Início](https://runapi.ai/pt-BR/.md)
- [Catálogo de modelos](https://runapi.ai/pt-BR/models.md)
- [Preços](https://runapi.ai/pt-BR/pricing.md)
- [Provedores](https://runapi.ai/pt-BR/models)
- [Documentação](https://runapi.ai/pt-BR/docs/guides)
- [SDKs](https://runapi.ai/pt-BR/sdk.md)
- [CLI](https://runapi.ai/pt-BR/cli.md)
- [Servidor MCP](https://runapi.ai/pt-BR/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md)
- [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/pt-BR/contact.md)
- [Contato](https://runapi.ai/pt-BR/contact.md)
- [Termos](https://runapi.ai/pt-BR/terms.md)
- [Privacidade](https://runapi.ai/pt-BR/privacy.md)
- [Índice do site para agentes](https://runapi.ai/llms.txt)

Contato: contact@runapi.ai

## Dados estruturados

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/pt-BR",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/pt-BR",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/pt-BRicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "TechArticle",
    "headline": "Início rápido",
    "description": "Chame modelos de linguagem do RunAPI por meio de um protocolo síncrono ou de streaming compatível.",
    "url": "https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart",
    "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart"
  }
]
```