Crear una respuesta de texto
Usa la API de Respuestas de ShareAI para generación de texto sin estado, historial explícito de conversaciones y eventos de transmisión de Respuestas.
En esta página
https://api.shareai.now/api/v1/responsesGenerar una respuesta de texto a partir de un prompt o conversación.
- URL base
https://api.shareai.now- Autenticación
- Clave API Bearer o token de acceso OAuth aprobado
Elige esta API cuando tu aplicación utilice el formato de mensaje de texto de Respuestas. Proporciona la conversación en cada solicitud; las respuestas no se almacenan para su recuperación posterior.
Envía una solicitud#
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 de solicitud#
| Campo | Valor |
|---|---|
model | Un modelo de chat disponible permitido por tu credencial. |
input | Una cadena no vacía, o hasta 256 mensajes de texto. |
instructions | Instrucciones del sistema opcionales precediendo la conversación. |
store | false; almacenar respuestas no es compatible. |
stream | false para JSON o true para eventos SSE de Respuestas. |
Continuar una conversación#
Envía mensajes anteriores en input junto con el siguiente mensaje del usuario. Los roles compatibles son user, assistant, system and developer. Las instrucciones para desarrolladores usan el rol del sistema internamente. El contenido del mensaje puede ser texto o 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
}
Leer el resultado#
La respuesta JSON es un response objeto. Lee el texto del asistente desde output[].content[] entradas con tipo output_text. Verifica el estado de la respuesta: completed es una respuesta finalizada; incomplete puede indicar un límite de tokens. Público usage actualmente es nulo; usa Uso de la consola para inspeccionar el uso procesado.
Transmite una respuesta#
Establece stream: true y analiza SSE. Los eventos incluyen response.created, response.output_text.delta y un response.completed, response.incomplete or response.failed. terminal. Agrega los deltas de texto en orden y maneja explícitamente el estado terminal.
Subconjunto compatible#
Este endpoint soporta la generación de texto. Respuestas almacenadas, previous_response_id, recuperación/eliminación, herramientas, entrada de imágenes, solicitudes en segundo plano y configuraciones de generación como temperature no son compatibles y se rechazan. Para configuraciones de generación basadas en mensajes compatibles con Chat Completions, utiliza Completaciones de Chat.
Usa un token de acceso OAuth#
Sustituye la clave API en el encabezado Authorization por un token de acceso OAuth aprobado. El surcharge alcance y el plan de uso aceptado son necesarios para la inferencia financiada por cuenta. Los alcances solo de identidad no autorizan gastos. Consulta alcances y permisos.
Última actualización septiembre 15, 2026