hunyuan-vision

Technische specificaties van hunyuan-vision

Wat is hunyuan-vision?

hunyuan-vision is het multimodale model voor beeldbegrip van Tencent Hunyuan, aangeboden via een OpenAI-compatibele API. In de officiële voorbeelden van Tencent wordt het gebruikt voor taken in de stijl van “image-to-text”, waarbij een gebruiker een prompt samen met een afbeelding verstuurt en het model vragen beantwoordt, zoals wat er op de afbeelding te zien is.

Praktisch gezien is dit model geschikt voor toepassingen die visuele redenering binnen een chatworkflow nodig hebben, zoals beeldonderschriften, scenebeschrijvingen, interpretatie van UI of screenshots, analyse van productafbeeldingen en algemene visuele vraagbeantwoording. Het integratiepatroon is vooral handig voor teams die al OpenAI-achtige clients gebruiken, omdat Tencent aangeeft dat ontwikkelaars kunnen overstappen door alleen het endpoint en de API-sleutelconfiguratie te vervangen.

Belangrijkste functies van hunyuan-vision

• Multimodaal beeldbegrip: hunyuan-vision accepteert zowel tekst- als afbeeldingscontent in dezelfde aanvraag, waardoor beeldbewuste gesprekken en vraagbeantwoording over geüploade afbeeldingen mogelijk zijn.
• OpenAI-compatibele interface: Tencent levert hunyuan-vision met dezelfde algemene verzoekstructuur als Chat Completions, wat de migratie-inspanning voor bestaande AI-toepassingen verkleint.
• Flexibele methoden voor afbeeldingsinvoer: Officiële voorbeelden tonen ondersteuning voor standaard externe afbeeldings-URL’s en base64-gecodeerde data-URL’s, wat helpt bij het werken met zowel publieke assets als lokaal verwerkte bestanden.
• SDK-vriendelijke integratie: Tencent documenteert expliciet gebruik met OpenAI-SDK’s in Python, Node.js, Go en HTTP-aanvragen in cURL-stijl, waardoor het eenvoudig is te integreren in bestaande backendservices.
• Chatgebaseerde workflow: Omdat het als een chat-completionmodel wordt aangeboden, past hunyuan-vision van nature in conversatie-apps, assistenten en toolchains die hun verzoeken al rondom messages structureren.
• Gebruiksgestuurde tokenberekening voor afbeeldingen: Tencent merkt op dat de kosten voor afbeeldingen afhangen van de afbeeldingsgrootte, met per-afbeelding tokenverbruik als een bereik in plaats van een vast bedrag.

Toegang en integratie van hunyuan-vision

Stap 1: API-sleutel aanmaken

Om toegang te krijgen tot hunyuan-vision, maakt en beveiligt u eerst uw API-sleutel via de console van de aanbieder. Tencent documenteert toegang op basis van een API-sleutel voor de OpenAI-compatibele Hunyuan-API, en de sleutel wordt als Bearer-token in verzoeken meegestuurd. Bewaar de sleutel in een omgevingsvariabele zoals HUNYUAN_API_KEY en stel deze niet bloot in client-side code of openbare repositories.

Stap 2: Verzoeken verzenden naar de hunyuan-vision-API

Gebruik het OpenAI-compatibele endpoint en specificeer hunyuan-vision als modelnaam.

curl --location 'https://api.hunyuan.cloud.tencent.com/v1/chat/completions' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HUNYUAN_API_KEY" \
  --data '{
    "model": "hunyuan-vision",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "What is in this image?"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://example.com/image.jpg"
            }
          }
        ]
      }
    ]
  }'

U kunt ook OpenAI-compatibele SDK’s gebruiken door de client naar de Hunyuan-basis-URL te wijzen:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("HUNYUAN_API_KEY"),
    base_url="https://api.hunyuan.cloud.tencent.com/v1",
)

response = client.chat.completions.create(
    model="hunyuan-vision",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Describe this image."},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://example.com/image.jpg"
                    },
                },
            ],
        }
    ],
)

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

Deze aanvraagstructuur komt overeen met de officiële, OpenAI-compatibele voorbeelden van Tencent voor hunyuan-vision.

Stap 3: Resultaten ophalen en verifiëren

Lees het gegenereerde antwoord uit de eerste completion-keuze, doorgaans response.choices[0].message.content bij gebruik van een OpenAI-compatibele SDK. Controleer in productie of de afbeeldings-URL bereikbaar is of dat uw base64-payload geldig is, en toets vervolgens de geretourneerde beschrijving aan de vereisten van uw toepassing wat betreft nauwkeurigheid, veiligheid en consistentie van de opmaak. De voorbeelden van Tencent tonen een standaardafhandeling van chat-completions, zodat bestaande validatie- en loggingpijplijnen meestal met minimale wijzigingen hergebruikt kunnen worden.