Hy4
tencent/hy4
The official release of Hy4 delivers comprehensive and substantial improvements over Hy4 Preview, with particularly strong gains in agentic capabilities and performance across a wide range of long-horizon, real-world…
Our discountYour discount
Official price−5%off the official priceUp to −10%off the official priceTier 3
- Tier 1—
- Tier 2−5%
- Tier 3−10%
Official $0.834 / $2.501Our price $0.834 / $2.501$0.792 / $2.376$0.751 / $2.251 Per 1M tokensTier 3: up to −10%
- Inputtext + imageOutput: text
- Context1.05M tokensUp to 66K output per reply
- ReleasedNovember 4, 2026In the OceanToken catalog
01 · Learn
What is Hy4?
Hy4 is a multimodal language model from Tencent on the OceanToken API, with a 1.05M-token context window and reasoning, tool calling, structured outputs and image input.
- −10%Our price vs official$0.751 / $2.251 Per 1M tokens · Official: $0.834 / $2.501
- 1.05MContext windowUp to 66K output per reply
- text + imageInputOutput: text
- Up to 60% offEnterprise rate vs officialUp to, by quote
What Hy4 can do.
- Multi-step reasoningreasoning_effort
- Tool-using agentstool_choice
- Structured outputs (JSON)response_format
- Image understandinginputs: text + image
02 · Compare
Is Hy4 cheaper than similar models?
The official price, then our price, for Hy4 and the models most like it.
OfficialOur price
- Hy4Tencent
$1.668$1.501−10%up to −60% Gemini 3.8 FlashGoogle
$2.25$2.025−10%up to −30%DeepSeek V4 ProDeepSeek
$2.64$1.584−40%up to −60%GLM 5.3Z.ai
$2.90$1.74−40%up to −60%Qwen3.8 MaxQwen
$4.00$3.60−10%up to −60%Kimi K2.7 CodeMoonshotAI
$2.475Up to 60% off
Per 1M tokens, half input and half output. Prices as of November 18, 2026. Enterprise rate: quote by email, we activate it for you.
Hy4 specs.
- Context window
- 1.05M tokens (1,048,576)
- Max output
- 66K tokens (65,536)
- Input
- text, image
- Output
- text
- Reasoning
- Yes,
reasoning_effort - Tool calling
- Yes,
tool_choice - Structured outputs
- Yes,
response_format - Prompt caching
- Yes, at the official price
- Released
- November 4, 2026
Model ID and endpoint
- OceanToken model ID
tencent/hy4- OpenAI-compatible base URL
https://api.oceantoken.ai/v1- Endpoint
POST /v1/chat/completions
03 · Buy and build
How much does the Hy4 API cost?
| Rate | Input | Output | Off |
|---|---|---|---|
| Official | |||
| Tier 1From sign-up | $0.834 | $2.501 | |
| Tier 2$1,000 total | $0.792 | $2.376 | −5% |
| Tier 3$10,000 total | $0.751 | $2.251 | −10% |
| Enterprise rateBy quote | up to −60% | ||
Thinking tokens are billed at the output price.
Per 1M tokens. Half input, half output: official $1.668, ours $1.501. Prompt cache and web search are billed at the official price, at every tier.
How tiers work
- Self-serveTier 1From sign-up
- Self-serveTier 2$1,000 total
- Self-serveTier 3$10,000 total
- By quoteEnterprise rateUp to 60% off, by quote
You pay per use from a prepaid balance, with no subscription. Official price: the model maker’s list price. Tier 1 to 3 are standing rates by total top-up.
How to use Hy4 on OceanToken.
Three steps from no account to a working request. The same key and balance work for every model in the catalog.
Create an account and get an API key
One key works for every model your account can use.
Get API KeyAdd credits
OceanToken is prepaid: add credits, and each request is billed from that balance.
Add creditsCall Hy4 from your code
Point an OpenAI SDK at
See the API request in docshttps://api.oceantoken.ai/v1and use the model IDtencent/hy4.
client.pyPythonfrom openai import OpenAI
# Your API Key from the OceanToken console
client = OpenAI(base_url="https://api.oceantoken.ai/v1",
api_key="YOUR_API_KEY")
reply = client.chat.completions.create(
model="tencent/hy4",
messages=[{"role": "user", "content": "Hello"}])
print(reply.choices[0].message.content)client.tsTypeScriptimport OpenAI from "openai";
// Your API Key from the OceanToken console
const client = new OpenAI({ baseURL: "https://api.oceantoken.ai/v1", apiKey: "YOUR_API_KEY" });
const reply = await client.chat.completions.create({
model: "tencent/hy4",
messages: [{ role: "user", content: "Hello" }],
});
console.log(reply.choices[0].message.content);request.mjsJavaScript// Your API Key from the OceanToken console
const KEY = "YOUR_API_KEY";
const res = await fetch("https://api.oceantoken.ai/v1/chat/completions", {
method: "POST",
headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ model: "tencent/hy4", messages: [{ role: "user", content: "Hello" }] }),
});
const reply = await res.json();
console.log(reply.choices[0].message.content);request.shcurl# Your API Key from the OceanToken console
curl https://api.oceantoken.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "tencent/hy4",
"messages": [{"role": "user", "content": "Hello"}]}'main.goGopackage main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
// Your API Key from the OceanToken console
body := strings.NewReader(`{"model": "tencent/hy4", "messages": [{"role": "user", "content": "Hello"}]}`)
req, _ := http.NewRequest("POST", "https://api.oceantoken.ai/v1/chat/completions", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}Main.javaJavaimport java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
// Your API Key from the OceanToken console
String body = "{\"model\": \"tencent/hy4\", \"messages\": [{\"role\": \"user\", \"content\": \"Hello\"}]}";
HttpRequest req = HttpRequest.newBuilder(URI.create("https://api.oceantoken.ai/v1/chat/completions"))
.header("Authorization", "Bearer YOUR_API_KEY")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());
}
}request.phpPHP<?php
// Your API Key from the OceanToken console
$ch = curl_init("https://api.oceantoken.ai/v1/chat/completions");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => '{"model": "tencent/hy4", "messages": [{"role": "user", "content": "Hello"}]}',
]);
echo curl_exec($ch);request.rbRubyrequire "net/http"
# Your API Key from the OceanToken console
uri = URI("https://api.oceantoken.ai/v1/chat/completions")
req = Net::HTTP::Post.new(uri, "Authorization" => "Bearer YOUR_API_KEY", "Content-Type" => "application/json")
req.body = '{"model": "tencent/hy4", "messages": [{"role": "user", "content": "Hello"}]}'
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.bodyHy4 API: frequently asked questions.
What is Hy4?
The official release of Hy4 delivers comprehensive and substantial improvements over Hy4 Preview, with particularly strong gains in agentic capabilities and performance across a wide range of long-horizon, real-world…
How much does Hy4 cost?
Hy4 costs $0.834 per 1M input tokens and $2.501 per 1M output tokens. Cached input costs $0.042 per 1M tokens. This is the publisher's official price. At the top cumulative top-up tier it costs $0.751 per 1M input tokens and $2.251 per 1M output tokens. Blended (50% input / 50% output): official $1.668 → top tier $1.501 (−10%). These are OceanToken starting prices as of November 18, 2026, charged per use to your prepaid balance. The console always shows the current price.
What is the context length of Hy4?
Hy4 has a context window of 1.05M tokens (1,048,576 tokens).
Does Hy4 support tool calling, vision and reasoning?
Hy4 supports tool calling, structured outputs, image input (vision) and reasoning. It takes text and image input and returns text.
How do I call Hy4 through the API?
Send requests to https://api.oceantoken.ai/v1/chat/completions with the model ID tencent/hy4 and your OceanToken API key. The API is OpenAI-compatible, so an OpenAI SDK needs only the base URL https://api.oceantoken.ai/v1 and your key. The Responses API and the Anthropic Messages API (/v1/messages) work too. The same OceanToken API key works for every model your account can use. Full reference: docs.oceantoken.ai.
How do I top up?
OceanToken is prepaid. Open Credits in the console, choose an amount and pay by card on Stripe's hosted checkout page (Link works too). Your balance updates a few seconds after payment. Have a trial code? Redeem it on the same page.
Do credits expire, and can I get a refund?
Purchased credits are valid for 12 months from the date of purchase. Credits from trial codes, promotions or gifts may have a shorter validity. All purchases are final and non-refundable, except where the law requires a refund. Section 6 of the Terms of Service has the details.
Am I charged for failed requests?
No. If a request fails, you are not charged: that covers a request refused for an insufficient balance or by a safety check, one whose provider fails before returning any output, and a video job that fails or is refused by a safety check, whose held amount goes back to your balance. The one exception: if a request breaks off after the model has started producing output, for example a stream cut off part-way, you pay for the tokens that were processed and generated for it.
Similar language models
- Qwen3.8 MaxOur discount−10%
- Qwen3.7 FlashOur discount−10%
- Kimi K2.7 Code
- MiniMax M3
- Kimi K3Our discount−20%
- Aion-2.0
Keep exploring
Sources
- OceanToken model catalog: every price, context window, input, output and parameter on this page (November 18, 2026).
- How tiers work: Tier 1 to 3 and the Enterprise rate.