ShareAI Platform Docs

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.

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

Generar 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
}'

Campos de solicitud#

CampoValor
modelUn modelo de chat disponible permitido por tu credencial.
inputUna cadena no vacía, o hasta 256 mensajes de texto.
instructionsInstrucciones del sistema opcionales precediendo la conversación.
storefalse; almacenar respuestas no es compatible.
streamfalse 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

Documentación de la plataforma ShareAI
Toda la documentación

Buscar por título o contenido.

Preguntar sobre esta página

Elige un asistente para explorar esta página. También puedes copiar la página y pegarla en tu conversación.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI