Text model

Hy4

tencent/hy4

tencent/hy4 is a language model from Tencent you can call on the OceanToken API, with a 1.05M-token context window and up to 66K output tokens; it supports reasoning, tool calling, image input.

At a glance

API

POST /v1/chat/completions (also /v1/responses and /v1/messages). Base URL https://api.oceantoken.ai, your OceanToken key as the bearer token. The OpenAI SDKs work unchanged; see the Quickstart.

Download this spec (JSON) · llms.txt for AI assistants

Basic

curl https://api.oceantoken.ai/v1/chat/completions \
  -H "Authorization: Bearer $OCEANTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "tencent/hy4",
  "messages": [
    {
      "role": "user",
      "content": "Write a haiku about the ocean."
    }
  ]
}'

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.oceantoken.ai/v1", api_key=os.environ["OCEANTOKEN_API_KEY"])
response = client.chat.completions.create(
    model="tencent/hy4",
    messages=[
        {
            "role": "user",
            "content": "Write a haiku about the ocean.",
        },
    ],
)
print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({baseURL: 'https://api.oceantoken.ai/v1', apiKey: process.env.OCEANTOKEN_API_KEY});
const response = await client.chat.completions.create({
  "model": "tencent/hy4",
  "messages": [
    {
      "role": "user",
      "content": "Write a haiku about the ocean."
    }
  ]
});
console.log(response.choices[0].message.content);

Image input

curl https://api.oceantoken.ai/v1/chat/completions \
  -H "Authorization: Bearer $OCEANTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "tencent/hy4",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What is in this image?"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/photo.jpg"
          }
        }
      ]
    }
  ]
}'

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.oceantoken.ai/v1", api_key=os.environ["OCEANTOKEN_API_KEY"])
response = client.chat.completions.create(
    model="tencent/hy4",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "What is in this image?"},
                {
                    "type": "image_url",
                    "image_url": {"url": "https://example.com/photo.jpg"},
                },
            ],
        },
    ],
)
print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({baseURL: 'https://api.oceantoken.ai/v1', apiKey: process.env.OCEANTOKEN_API_KEY});
const response = await client.chat.completions.create({
  "model": "tencent/hy4",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What is in this image?"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/photo.jpg"
          }
        }
      ]
    }
  ]
});
console.log(response.choices[0].message.content);

Request parameters

Only what this model takes. Anything else in the request is left out before it reaches the model.

Message content

Besides a plain string, a message's content can be a list of parts:

image_url

An image, as a public https:// URL or a data URL.

{
  "type": "image_url",
  "image_url": {
    "url": "https://example.com/photo.jpg"
  }
}

Response

With stream: true, chat.completion.chunk events carry choices[].delta; the stream ends with data: [DONE].

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1792000000,
  "model": "tencent/hy4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "...",
        "reasoning_content": null,
        "tool_calls": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 20,
    "total_tokens": 32,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 0
    }
  }
}

More examples and how errors and billing work: Text generation.

Compared with similar models

Text models on OceanToken in the same price range as tencent/hy4. Compare their prices on oceantoken.ai.

More from Tencent

• Hunyuan A13B Instruct tencent/hunyuan-a13b-instruct
• Hy Mt2 1.8b tencent/hy-mt2-1.8b
• Hy Mt2 30B A3B tencent/hy-mt2-30b-a3b
• Hy Mt2 7B tencent/hy-mt2-7b
• Hy3 tencent/hy3
• Hy3 Preview tencent/hy3-preview
• Hy4 Preview tencent/hy4-preview

All Tencent models on OceanToken

Use it

Create an account Price on oceantoken.ai

The facts on this page were read from the live OceanToken catalog on 2026-11-14 (UTC), when the documentation was built. Prices are published on oceantoken.ai.