Hunyuan Hy4 Preview

ID da solicitação hy4-preview

Protocolos

POST /v1/chat/completions · Chat Completions · exemplo
POST /v1/messages · Anthropic Messages · exemplo
POST /v1/responses · OpenAI Responses · exemplo

Autenticação

Obtenha uma chave em Gerenciar chaves de API. Para requisições JSON, defina Content-Type: application/json.

Authorization: Bearer YOUR_API_KEY
Anthropic Messages · x-api-key: YOUR_API_KEY

Parâmetros da requisição

`POST /v1/chat/completions`

Campo	Tipo	Obrigatório	Descrição
`model`	`string`	Obrigatório	Defina o ID do modelo como `hy4-preview`.
`messages`	`object[]`	Obrigatório	Envie as mensagens na ordem da conversa. Cada mensagem contém `role` e `content`.
`messages[].content`	`string / object[]`	Condicional	Corpo da mensagem. Use texto simples ou um array de blocos de conteúdo definidos pelo protocolo.
`stream`	`boolean`	Opcional	`true` solicita um fluxo SSE. `false` solicita uma resposta JSON. Os modos disponíveis dependem do endpoint.
`max_completion_tokens`	`integer`	Condicional	Limita os tokens gerados, incluindo tokens de raciocínio quando aplicável. Use em endpoints que aceitem o campo.
`max_tokens`	`integer`	Condicional	Campo de compatibilidade para limitar tokens de saída. Use este campo ou `max_completion_tokens` conforme o endpoint.
`temperature`	`number`	Condicional	Controla a aleatoriedade da amostragem. Os valores aceitos e a aplicação do campo dependem do modelo e do endpoint.
`top_p`	`number`	Condicional	Limita candidatos da amostragem por probabilidade acumulada. Use quando o modelo e o endpoint oferecerem suporte.
`response_format`	`object`	Condicional	Para saída estruturada, use `type: json_object`, ou `type: json_schema` com `json_schema` quando o endpoint aceitar esquemas.

`POST /v1/messages`

Campo	Tipo	Obrigatório	Descrição
`model`	`string`	Obrigatório	Defina o ID do modelo como `hy4-preview`.
`messages`	`object[]`	Obrigatório	Envie as mensagens `user` e `assistant` em ordem. Coloque instruções de sistema no campo `system` de nível superior.
`messages[].content`	`string / object[]`	Obrigatório	Corpo da mensagem. Use texto simples ou um array de blocos de conteúdo definidos pelo protocolo.
`system`	`string / object[]`	Opcional	Instruções de sistema em texto ou em um array de blocos de texto.
`max_tokens`	`integer`	Obrigatório	Limita o número de tokens de saída. O limite aceito depende do modelo e do endpoint.
`stream`	`boolean`	Opcional	`true` solicita um fluxo SSE. `false` solicita uma resposta JSON. Os modos disponíveis dependem do endpoint.
`temperature`	`number`	Condicional	Controla a aleatoriedade da amostragem. Os valores aceitos e a aplicação do campo dependem do modelo e do endpoint.
`top_p`	`number`	Condicional	Limita candidatos da amostragem por probabilidade acumulada. Use quando o modelo e o endpoint oferecerem suporte.

`POST /v1/responses`

Campo	Tipo	Obrigatório	Descrição
`model`	`string`	Obrigatório	Defina o ID do modelo como `hy4-preview`.
`input`	`string / object[]`	Obrigatório	Texto de entrada ou array ordenado de itens. Itens de mensagem usam `role` e `content`.
`instructions`	`string`	Opcional	Instruções para o modelo sobre a tarefa e os requisitos da saída.
`max_output_tokens`	`integer`	Opcional	Limita o número de tokens de saída. O limite aceito depende do modelo e do endpoint.
`stream`	`boolean`	Opcional	`true` solicita um fluxo SSE. `false` solicita uma resposta JSON. Os modos disponíveis dependem do endpoint.
`store`	`boolean`	Condicional	Quando o campo for aceito, `false` solicita que a resposta não seja armazenada para recuperação posterior.
`text.format`	`object`	Condicional	Use `text.format` para saída estruturada, por exemplo `type: json_schema`. Use apenas em endpoints que aceitem o formato.
`temperature`	`number`	Condicional	Controla a aleatoriedade da amostragem. Os valores aceitos e a aplicação do campo dependem do modelo e do endpoint.
`top_p`	`number`	Condicional	Limita candidatos da amostragem por probabilidade acumulada. Use quando o modelo e o endpoint oferecerem suporte.

Exemplos de requisição

Defina a chave de API na variável de ambiente local ICODEEASY_API_KEY e escolha um endpoint que aceite chamadas HTTP diretas. Caso o endpoint exija um cliente específico, siga o guia de configuração desse cliente.

Chat Completions

bash

curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "hy4-preview",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ],
  "stream": false
}'

Anthropic Messages

bash

curl -sS 'https://api.icodeeasy.cc/v1/messages' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "hy4-preview",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

OpenAI Responses

bash

curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "hy4-preview",
  "instructions": "You are a helpful assistant.",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ],
  "stream": true,
  "store": false
}'

Ler a resposta

Chat Completions · Leia o texto em choices[].message.content. Em um fluxo SSE, os incrementos aparecem em choices[].delta. JSON · SSE
Anthropic Messages · Leia os blocos do tipo text em content[]. Em streaming, processe os eventos SSE de blocos de conteúdo na ordem. JSON · SSE
OpenAI Responses · Em streaming, concatene os campos delta dos eventos response.output_text.delta e trate os eventos de conclusão e falha. SSE