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.
Nesta página
https://api.shareai.now/api/v1/responsesGerar 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
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_CHAT_MODEL', 'input': 'Explain semantic search in two sentences.', 'instructions': 'Use plain language.', 'store': False, 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/responses', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/responses";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_CHAT_MODEL",
"input": "Explain semantic search in two sentences.",
"instructions": "Use plain language.",
"store": false,
"stream": false
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
Campos da solicitação#
| Campo | Valor |
|---|---|
model | Um modelo de chat disponível permitido pelas suas credenciais. |
input | Uma string não vazia ou até 256 mensagens de texto. |
instructions | Instruções do sistema opcionais adicionadas ao início da conversa. |
store | false; armazenar respostas não é suportado. |
stream | false 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