Hunyuan-T1-Vision 视觉深度思考大模型 API 接口、参数 & 代码示例

此 API 接口兼容 OpenAI 的接口规范，也就是可以直接使用 OpenAI 的 SDK 来调用各个模型。仅需替换以下两项配置即可：

1. base_url 替换为 https://wcode.net/api/gpt/v1
2. api_key 替换为从 https://wcode.net/get-apikey 获取到的 API Key

具体可参考下方的各编程语言代码示例中的 openai sdk 调用示例。

# TODO: 以下代码中的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey

curl --request POST 'https://wcode.net/api/gpt/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
    "model": "hunyuan-t1-vision",
    "messages": [
        {
            "role": "user",
            "content": "你好"
        }
    ]
}'

import Foundation

let headers = [
  "Authorization": "Bearer API_KEY",     // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
  "content-type": "application/json"
]
let parameters = [
  "model": "hunyuan-t1-vision",
  "messages": [
    [
      "role": "user",
      "content": "你好"
    ]
  ]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://wcode.net/api/gpt/v1/chat/completions")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 60.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

var headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer API_KEY'     // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
};
var request = http.Request('POST', Uri.parse('https://wcode.net/api/gpt/v1/chat/completions'));
request.body = json.encode({
  "model": "hunyuan-t1-vision",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ]
});
request.headers.addAll(headers);

http.StreamedResponse response = await request.send();

if (response.statusCode == 200) {
  print(await response.stream.bytesToString());
}
else {
  print(response.reasonPhrase);
}

require 'uri'
require 'net/http'

url = URI("https://wcode.net/api/gpt/v1/chat/completions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer API_KEY'     # TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
request["content-type"] = 'application/json'
request.body = "{\"model\":\"hunyuan-t1-vision\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"

response = http.request(request)
puts response.read_body

use serde_json::json;
use reqwest;

#[tokio::main]
pub async fn main() {
  let url = "https://wcode.net/api/gpt/v1/chat/completions";

  let payload = json!({
    "model": "hunyuan-t1-vision",
    "messages": (
      json!({
        "role": "user",
        "content": "你好"
      })
    )
  });

  let mut headers = reqwest::header::HeaderMap::new();
  headers.insert("Authorization", "Bearer API_KEY".parse().unwrap());     // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
  headers.insert("content-type", "application/json".parse().unwrap());

  let client = reqwest::Client::new();
  let response = client.post(url)
    .headers(headers)
    .json(&payload)
    .send()
    .await;

  let results = response.unwrap()
    .json::<serde_json::Value>()
    .await
    .unwrap();

  dbg!(results);
}

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://wcode.net/api/gpt/v1/chat/completions");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer API_KEY");    // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
headers = curl_slist_append(headers, "content-type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"model\":\"hunyuan-t1-vision\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}");

CURLcode ret = curl_easy_perform(hnd);

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {
  url := "https://wcode.net/api/gpt/v1/chat/completions"

  payload := strings.NewReader("{\"model\":\"hunyuan-t1-vision\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}")

  req, _ := http.NewRequest("POST", url, payload)

  req.Header.Add("Authorization", "Bearer API_KEY")     // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
  req.Header.Add("content-type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

using System.Net.Http.Headers;


var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Post, "https://wcode.net/api/gpt/v1/chat/completions");

request.Headers.Add("Authorization", "Bearer API_KEY");     // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey

request.Content = new StringContent("{\"model\":\"hunyuan-t1-vision\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}", null, "application/json");

var response = await client.SendAsync(request);

response.EnsureSuccessStatusCode();

Console.WriteLine(await response.Content.ReadAsStringAsync());

var client = new RestClient("https://wcode.net/api/gpt/v1/chat/completions");

var request = new RestRequest("", Method.Post);

request.AddHeader("Authorization", "Bearer API_KEY");     // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey

request.AddHeader("content-type", "application/json");

request.AddParameter("application/json", "{\"model\":\"hunyuan-t1-vision\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}", ParameterType.RequestBody);

var response = client.Execute(request);

const axios = require('axios');

let data = JSON.stringify({
  "model": "hunyuan-t1-vision",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ]
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://wcode.net/api/gpt/v1/chat/completions',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer API_KEY'     // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
  },
  data : data
};

axios.request(config).then((response) => {
  console.log(JSON.stringify(response.data));
}).catch((error) => {
  console.log(error);
});

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");

RequestBody body = RequestBody.create(mediaType, "{\"model\":\"hunyuan-t1-vision\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}");

Request request = new Request.Builder()
  .url("https://wcode.net/api/gpt/v1/chat/completions")
  .post(body)
  .addHeader("Authorization", "Bearer API_KEY")             // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

$client = new \GuzzleHttp\Client();

$headers = [
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer API_KEY',     // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
];

$body = '{
  "model": "hunyuan-t1-vision",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ]
}';

$request = new \GuzzleHttp\Psr7\Request('POST', 'https://wcode.net/api/gpt/v1/chat/completions', $headers, $body);

$response = $client->sendAsync($request)->wait();

echo $response->getBody();

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://wcode.net/api/gpt/v1/chat/completions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 5,
  CURLOPT_TIMEOUT => 300,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'hunyuan-t1-vision',
    'messages' => [
      [
        'role' => 'user',
        'content' => '你好'
      ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer API_KEY",     // TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
    "content-type: application/json",
  ],
]);

$response = curl_exec($curl);
$error = curl_error($curl);

curl_close($curl);

if ($error) {
  echo "cURL Error #:" . $error;
} else {
  echo $response;
}

import requests
import json

url = "https://wcode.net/api/gpt/v1/chat/completions"

payload = {
  "model": "hunyuan-t1-vision",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ]
}

headers = {
  "Authorization": "Bearer API_KEY",     # TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
  "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(json.dumps(response.json(), indent=4, ensure_ascii=False))

from openai import OpenAI

client = OpenAI(
  base_url="https://wcode.net/api/gpt/v1",
  api_key="API_KEY"                             # TODO: 这里的 API_KEY 需要替换，获取 API Key 入口：https://wcode.net/get-apikey
)

completion = client.chat.completions.create(
  model="hunyuan-t1-vision",
  messages=[
    {
      "role": "user",
      "content": "你好"
    }
  ]
)

print(completion.choices[0].message.content)

{
    "id": "chatcmpl-t1768918367s409r4889cb2b9a43acddc66cd665",
    "object": "chat.completion",
    "created": 1768918401,
    "model": "hunyuan-t1-vision",
    "system_fingerprint": "",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "你好！我是 **Hunyuan-T1-Vision**，是腾讯基于 **混元大模型（Hunyuan）** 体系打造的一款 **视觉深度思考大模型**。\n\n### 我的特点可以概括为以下几点：\n\n---\n\n## 🧠 一、我是谁？\n\n我是一个结合了 **视觉理解能力** 和 **深度推理能力** 的多模态大模型，不仅能够“看懂”图像，还能像人类一样进行深入的思考、分析和推理，帮助你解决与图像相关的复杂问题。\n\n---\n\n## 👁️ 二、我的核心能力\n\n### 1. **强大的视觉理解能力**\n- 我可以识别和理解各种类型的图像内容，包括但不限于：\n  - 自然场景（风景、街道等）\n  - 文档图片（文字、表格、图表、PDF截图等）\n  - 照片（人物、物品、场景细节）\n  - 图表与数据可视化（柱状图、饼图、流程图等）\n  - 手写文字、数学公式、示意图等\n- 不仅能识别图中有什么，还能理解其中的上下文、逻辑关系和隐含信息。\n\n### 2. **深度思考与推理能力**\n- 我不只是“看图说话”，而是会像人一样进行**多步推理、逻辑分析、归纳总结**。\n- 面对复杂任务（比如从图表中推导结论、分析图像中的异常、辅助决策等），我能逐步拆解问题，给出条理清晰的分析过程和可信的答案。\n\n### 3. **多模态交互**\n- 你可以上传图片，我能够图文结合地理解你的问题，并给出精准回答。\n- 支持**“视觉+文本”联合推理**，例如：根据一张设计图提出改进建议，或根据实验图表分析趋势并给出科学解释。\n\n---\n\n## 💡 三、我能帮你做什么？\n\n以下是我可以为你提供帮助的一些典型场景：\n\n| 应用场景 | 示例 |\n|---------|------|\n| **教育学习** | 看图解题、分析实验装置图、解读生物/化学结构图、辅助阅读教材插图等 |\n| **办公与文档** | 读取扫描版 PDF、表格图片内容，提取关键信息，总结文档要点 |\n| **设计与创意** | 分析设计稿、UI界面图，提供优化建议；解读艺术作品风格与构图 |\n| **科研与数据分析** | 解读科研论文中的图表、实验结果图，辅助数据分析和结论推导 |\n| **生活实用** | 识别商品、植物、地标、钞票、发票等；帮助理解复杂说明书或示意图 |\n| **医疗辅助（非诊断用途）** | 辅助查看医学影像图说明、健康科普图解等（不替代专业医疗意见） |\n\n---\n\n## 🔍 四、我与其他模型的不同之处？\n\n- **深度思考链条**：我不仅给出答案，还会展示我的推理过程，帮助你理解“为什么”。\n- **视觉+语言深度融合**：不是简单的“看图+回答”，而是真正将图像信息与语言推理融为一体，进行综合判断。\n- **高精度与高鲁棒性**：针对复杂、模糊、多元素图像，我也具备较强的理解和适应能力。\n\n---\n\n## 🤝 五、如何使用我？\n\n你可以通过以下方式与我互动：\n\n1. **上传图片 + 提问**：直接发送你想要我看的图片，并提出具体问题，比如“这张图讲了什么？”、“这个图表说明了什么趋势？”、“这里可能出了什么问题？”等。\n2. **纯文本问题**：如果你暂时没有图片，也可以像普通大模型一样，和我进行文本交流，我同样具备强大的语言理解与生成能力。\n3. **图文结合任务**：描述你希望我如何结合图像与文字信息来帮你解决问题，我会按步骤推理并给出答案。\n\n---\n\n## ✨ 总结\n\n我是 **Hunyuan-T1-Vision**，一个会“深度思考”的视觉大模型，致力于成为你在图像理解、视觉分析、复杂推理上的得力助手。无论你是学生、科研人员、设计师，还是普通用户，只要你需要“看懂图”并“想明白”，我都可以帮你做到。\n\n欢迎你随时上传图片或提出问题，我们一起来探索视觉世界的奥秘吧！🔍✨"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 35,
        "completion_tokens": 913,
        "total_tokens": 948
    },
    "note": "以上内容为AI生成，不代表开发者立场，请勿删除或修改本标记"
}