TextoClaudeClaude

Claude - API de mensajes

Envía una lista estructurada de mensajes de entrada con contenido de texto y/o imagen, y el modelo generará el siguiente mensaje en la conversación.

La API de Mensajes se puede usar para consultas individuales o conversaciones de múltiples turnos sin estado.

<Note> **BaseURL**: La BaseURL predeterminada es `https://api.starmagic.ai`, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. `https://api.starmagic.ai` es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto. </Note>

Autorización

AuthorizationstringheaderObligatorio

##Todas las APIs requieren autenticación Bearer Token## **Obtener API Key:** Visita la [Página de gestión de API Key](https://starmagic.ai/app/api-keys) para obtener tu API Key **Agregar al encabezado de la solicitud:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

Cuerpo de solicitud

application/json

El modelo que completará su prompt.

"claude-haiku-4-5-20251001"

messagesobject[]Obligatorio

Mensajes de entrada. Nuestros modelos están entrenados para operar en turnos conversacionales alternos de `user` y `assistant`. Al crear un nuevo `Message`, se especifican los turnos conversacionales previos con el parámetro `messages`, y el modelo genera el siguiente `Message` en la conversación. Los turnos consecutivos de `user` o `assistant` en su solicitud se combinarán en un solo turno. Cada mensaje de entrada debe ser un objeto con `role` y `content`. Puede especificar un solo mensaje con rol `user`, o puede incluir múltiples mensajes de `user` y `assistant`.

[
  {
    "content": null,
    "role": "user"
  }
]

max_tokensintegerObligatorio

El número máximo de tokens a generar antes de detenerse. Tenga en cuenta que nuestros modelos pueden detenerse _antes_ de alcanzar este máximo. Este parámetro solo especifica el número máximo absoluto de tokens a generar.

inference_geostring

Especifica la región geográfica para el procesamiento de inferencia. Si no se especifica, se usa `default_inference_geo` del espacio de trabajo.

"string"

containerobject

Identificador de contenedor para reutilización entre solicitudes.

context_managementobject

Configuración de gestión de contexto.

mcp_serversobject[]

Servidores MCP a utilizar en esta solicitud

[
  {
    "authorization_token": null,
    "name": "string",
    "tool_configuration": null,
    "type": "string",
    "url": "string"
  }
]

metadataobject

{
  "user_id": null
}

output_configobject

{
  "effort": "low",
  "format": {
    "schema": {},
    "type": "string"
  },
  "task_budget": {
    "remaining": 0,
    "total": 0,
    "type": "string"
  }
}

service_tierenum<auto | standard_only>

Determina si se usa la capacidad prioritaria (si está disponible) o la capacidad estándar para esta solicitud.

"auto"

stop_sequencesstring[]

Secuencias de texto personalizadas que harán que el modelo deje de generar.

[
  "string"
]

streamboolean

Si transmitir incrementalmente la respuesta usando eventos enviados por el servidor.

true

systemobject

Prompt del sistema.

temperaturenumber

Cantidad de aleatoriedad inyectada en la respuesta. Por defecto es `1.0`. Rango de `0.0` a `1.0`.

thinkingobject

Configuración para habilitar el pensamiento extendido de Claude. `type: "enabled"` requiere `budget_tokens`, con un mínimo de 1.024, y cuenta dentro de `max_tokens`. Puedes usar `display` para controlar cómo se muestran los contenidos de pensamiento. `type: "adaptive"` permite que Claude decida dinámicamente cuándo y cuánto pensamiento extendido usar según la complejidad de la solicitud; también puedes usar `display` para controlar cómo se muestran los contenidos de pensamiento. `type: "disabled"` desactiva el pensamiento extendido.

tool_choiceobject

Cómo el modelo debe usar las herramientas proporcionadas.

toolsobject[]

Definiciones de herramientas que el modelo puede usar.

[
  null
]

top_kinteger

Solo muestrear de las K opciones principales para cada token subsiguiente.

top_pnumber

Usar muestreo de núcleo.

Respuesta

application/json

成功

Cuerpo de respuesta

idstringObligatorio

Identificador único del objeto. El formato y la longitud de los IDs pueden cambiar con el tiempo.

"string"

typestringObligatorio

Tipo de objeto. Para Messages, esto siempre es `"message"`.

"string"

rolestringObligatorio

Rol conversacional del mensaje generado. Esto siempre será `"assistant"`.

"string"

contentobject[]Obligatorio

Contenido generado por el modelo. Este es un array de bloques de contenido, cada uno con un `type` que determina su forma.

[
  null
]

El modelo que procesó la solicitud.

"claude-haiku-4-5-20251001"

La razón por la que nos detuvimos.

"end_turn"

stop_sequencestringObligatorio

Qué secuencia de parada personalizada se generó, si alguna.

"string"

usageobjectObligatorio

{
  "cache_creation": null,
  "cache_creation_input_tokens": null,
  "cache_read_input_tokens": null,
  "input_tokens": 0,
  "output_tokens": 0,
  "server_tool_use": null,
  "service_tier": null
}

context_managementobject

Respuesta de gestión de contexto.

containerobject

Información sobre el contenedor utilizado en esta solicitud.

POST/v1/messages

curl --request POST \
  --url https://api.starmagic.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, world"
    }
  ]
}'

Respuesta: 成功

{
  "model": "claude-haiku-4-5-20251001",
  "id": "msg_bdrk_017XLrAa77zWvfBGQ6ESvrxz",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "# Hey there! 👋\n\nHow's it going? What can I help you with today?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 8,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 24
  }
}

Claude - API de mensajes

Envía una lista estructurada de mensajes de entrada con contenido de texto y/o imagen, y el modelo generará el siguiente mensaje en la conversación.

La API de Mensajes se puede usar para consultas individuales o conversaciones de múltiples turnos sin estado.

Autorización

AuthorizationstringheaderObligatorio

Authorization: Bearer YOUR_API_KEY

Cuerpo de solicitud

application/json

El modelo que completará su prompt.

"claude-haiku-4-5-20251001"

messagesobject[]Obligatorio

[
  {
    "content": null,
    "role": "user"
  }
]

max_tokensintegerObligatorio

inference_geostring

Especifica la región geográfica para el procesamiento de inferencia. Si no se especifica, se usa `default_inference_geo` del espacio de trabajo.

"string"

containerobject

Identificador de contenedor para reutilización entre solicitudes.

context_managementobject

Configuración de gestión de contexto.

mcp_serversobject[]

Servidores MCP a utilizar en esta solicitud

[
  {
    "authorization_token": null,
    "name": "string",
    "tool_configuration": null,
    "type": "string",
    "url": "string"
  }
]

metadataobject

{
  "user_id": null
}

output_configobject

{
  "effort": "low",
  "format": {
    "schema": {},
    "type": "string"
  },
  "task_budget": {
    "remaining": 0,
    "total": 0,
    "type": "string"
  }
}

service_tierenum<auto | standard_only>

Determina si se usa la capacidad prioritaria (si está disponible) o la capacidad estándar para esta solicitud.

"auto"

stop_sequencesstring[]

Secuencias de texto personalizadas que harán que el modelo deje de generar.

[
  "string"
]

streamboolean

Si transmitir incrementalmente la respuesta usando eventos enviados por el servidor.

true

systemobject

Prompt del sistema.

temperaturenumber

Cantidad de aleatoriedad inyectada en la respuesta. Por defecto es `1.0`. Rango de `0.0` a `1.0`.

thinkingobject

tool_choiceobject

Cómo el modelo debe usar las herramientas proporcionadas.

toolsobject[]

Definiciones de herramientas que el modelo puede usar.

[
  null
]

top_kinteger

Solo muestrear de las K opciones principales para cada token subsiguiente.

top_pnumber

Usar muestreo de núcleo.

Respuesta

application/json

成功

Cuerpo de respuesta

idstringObligatorio

Identificador único del objeto. El formato y la longitud de los IDs pueden cambiar con el tiempo.

"string"

typestringObligatorio

Tipo de objeto. Para Messages, esto siempre es `"message"`.

"string"

rolestringObligatorio

Rol conversacional del mensaje generado. Esto siempre será `"assistant"`.

"string"

contentobject[]Obligatorio

Contenido generado por el modelo. Este es un array de bloques de contenido, cada uno con un `type` que determina su forma.

[
  null
]

El modelo que procesó la solicitud.

"claude-haiku-4-5-20251001"

La razón por la que nos detuvimos.

"end_turn"

stop_sequencestringObligatorio

Qué secuencia de parada personalizada se generó, si alguna.

"string"

usageobjectObligatorio

{
  "cache_creation": null,
  "cache_creation_input_tokens": null,
  "cache_read_input_tokens": null,
  "input_tokens": 0,
  "output_tokens": 0,
  "server_tool_use": null,
  "service_tier": null
}

context_managementobject

Respuesta de gestión de contexto.

containerobject

Información sobre el contenedor utilizado en esta solicitud.

curl --request POST \ --url https://api.starmagic.ai/v1/messages \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "claude-sonnet-4-5-20250929", "max_tokens": 1024, "messages": [ { "role": "user", "content": "Hello, world" } ] }'

{ "model": "claude-haiku-4-5-20251001", "id": "msg_bdrk_017XLrAa77zWvfBGQ6ESvrxz", "type": "message", "role": "assistant", "content": [ { "type": "text", "text": "# Hey there! 👋\n\nHow's it going? What can I help you with today?" } ], "stop_reason": "end_turn", "stop_sequence": null, "usage": { "input_tokens": 8, "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0, "output_tokens": 24 } }