ShareAI Platform Docs

Criar uma resposta de texto

Use a API de Respostas do ShareAI para geração de texto sem estado, histórico explícito de conversas e eventos de streaming de Respostas.

Ver como Markdown
Nesta página
POST https://api.shareai.now/api/v1/responses

Gerar uma resposta de texto a partir de um prompt ou conversa.

URL Base
https://api.shareai.now
Autenticação
Chave de API Bearer ou token de acesso OAuth aprovado

Escolha esta API quando sua aplicação usar o formato de mensagem de texto Respostas. Forneça a conversa em cada solicitação; as respostas não são armazenadas para recuperação posterior.

Enviar uma solicitação#

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/responses" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_CHAT_MODEL",
  "input": "Explain semantic search in two sentences.",
  "instructions": "Use plain language.",
  "store": false,
  "stream": false
}'

Campos da solicitação#

CampoValor
modelUm modelo de chat disponível permitido pelas suas credenciais.
inputUma string não vazia ou até 256 mensagens de texto.
instructionsInstruções do sistema opcionais adicionadas ao início da conversa.
storefalse; armazenar respostas não é suportado.
streamfalse para JSON ou true para eventos SSE de Respostas.

Continuar uma conversa#

Envie mensagens anteriores em input junto com a próxima mensagem do usuário. Os papéis suportados são user, assistant, system and developer. Instruções para desenvolvedores usam o papel do sistema internamente. O conteúdo da mensagem pode ser texto ou input_text/output_text partes.

JSON

{
  "model": "YOUR_CHAT_MODEL",
  "input": [
    {
      "role": "user",
      "content": "What is semantic search?"
    },
    {
      "role": "assistant",
      "content": "It finds results by meaning rather than exact words."
    },
    {
      "role": "user",
      "content": "Give one example."
    }
  ],
  "store": false
}

Ler o resultado#

A resposta JSON é um response objeto. Leia o texto do assistente a partir de output[].content[] entradas com o tipo output_text. Verifique o status da resposta: completed é uma resposta concluída; incomplete pode indicar um limite de tokens. Público usage está atualmente nulo; use o Console de Utilização para inspecionar a utilização processada.

Transmita uma resposta#

Defina stream: true e analise o SSE. Os eventos incluem response.created, response.output_text.delta e um response.completed, response.incomplete ou response.failed. terminal. Anexe os deltas de texto na ordem e lide explicitamente com o status terminal.

Subconjunto suportado#

Este endpoint suporta geração de texto. Respostas armazenadas, previous_response_id, recuperação/eliminação, ferramentas, entrada de imagem, pedidos em segundo plano e definições de geração, como temperature não são suportados e são rejeitados. Para definições de geração baseadas em mensagens suportadas por Chat Completions, utilize Conclusões de Chat.

Use um token de acesso OAuth#

Substitua a chave da API no cabeçalho Authorization por um token de acesso OAuth aprovado. O surcharge âmbito e o plano de utilização aceito são necessários para inferência financiada pela conta. Âmbitos apenas de identidade não autorizam despesas. Consulte âmbitos e permissões.

Última atualização em 15 de setembro de 2026

Documentação da Plataforma ShareAI
Toda a documentação

Pesquisar por título ou conteúdo.

Perguntar sobre esta página

Escolha um assistente para explorar esta página. Também pode copiar a página e colá-la na sua conversa.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI