Hunyuan + live news
Tencent's family, deployed across its own products. The OpenAI-compatible gateway is the simplest way in; the older Tencent Cloud signed API is not worth the effort for this.
| Vendor | Tencent, China |
|---|---|
| Base URL | https://api.hunyuan.cloud.tencent.com/v1 |
| Model id | hunyuan-turbos-latest |
| Model credential | HUNYUAN_API_KEY |
| Tool format | OpenAI-compatible — the tool schema below is the same one every other OpenAI-shaped provider takes. Only the base URL and model name change. |
| News API key | none required |
| Vendor docs | https://cloud.tencent.com/document/product/1729 |
Base URLs and model ids change often, and several vendors run separate mainland and international endpoints with non-interchangeable keys. Check the vendor docs above before copying. The part that does not change is the tool itself — our API has no key, no version negotiation and no SDK.
Working example
import json, os, requests
from openai import OpenAI
client = OpenAI(
api_key=os.environ["HUNYUAN_API_KEY"],
base_url="https://api.hunyuan.cloud.tencent.com/v1",
)
TOOLS = [{
"type": "function",
"function": {
"name": "search_news",
"description": ("Search worldwide news published in the last 30 days. "
"Free, keyless. Use 2-5 keywords, not a question."),
"parameters": {
"type": "object",
"properties": {
"q": {"type": "string"},
"date": {"type": "string",
"enum": ["today", "yesterday", "24h", "7d", "30d"]},
"lang": {"type": "string"},
"size": {"type": "integer"},
},
"required": ["q"],
},
},
}]
IDENT = { # optional, but it is what keeps this API open
"agent_name": "news-agent",
"software": "hunyuan",
"model": "hunyuan-turbos-latest",
}
msgs = [{"role": "user", "content": "What happened with grain exports this week?"}]
while True:
r = client.chat.completions.create(
model="hunyuan-turbos-latest", messages=msgs, tools=TOOLS)
msg = r.choices[0].message
msgs.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for tc in msg.tool_calls:
args = json.loads(tc.function.arguments)
data = requests.get("https://freenewsapi.ai/v1/search",
params={**args, **IDENT}, timeout=20).json()
msgs.append({"role": "tool", "tool_call_id": tc.id,
"content": json.dumps(data)[:60000]})Worth knowing about Hunyuan
- Two entirely different APIs share the name: the compatible gateway above and the signed Tencent Cloud API. Use the gateway.
- Streaming and tool calling together behave differently across model versions — test with streaming off first.
Test the tool without the model
Before debugging a tool-calling loop, confirm the data side works. It needs no credentials, so this runs anywhere:
curl "https://freenewsapi.ai/v1/search?q=grain+exports&date=7d&size=5"If that returns results and your loop still fails, the problem is in the model's tool handling, not in the data.
Prompt it properly
The single most common failure is the model phrasing the query as a sentence. Search is
AND across every term, so q=what happened with grain exports matches nothing.
Put this in the system prompt:
Use search_news for anything about current events or recent developments.
Phrase the query as 2-5 keywords that would appear in a headline, never as a question.
Good: "grain export prices". Bad: "what is happening with grain exports".
Scan titles first. Only request full_text for articles you will actually cite.
If a search returns nothing, drop the least essential keyword and try once more.
No results means no coverage in this corpus \u2014 not that the event did not happen.More in system prompts.
Same format
Hunyuan uses the openai tool-calling shape. These take the same code with a different base URL and model name: Qwen, DeepSeek, MiniMax, Kimi, GLM.
