Skip to content

Vega VL Integration Docs Updated โ€‹

Updated

The API documentation for Vega VL, our multimodal understanding model, has been comprehensively expanded. The endpoint and model IDs are unchanged, so existing integrations keep working without modification.

Model IDPositioning
wand-vega-vl-1.0-liteCost first โ€” short-video understanding, high-volume image classification
wand-vega-vl-1.0-flashBalanced โ€” data labeling, summarizing mid-length videos
wand-vega-vl-1.0-proQuality first โ€” long-video understanding, complex understanding tasks

1. What's New โ€‹

SectionDescription
Choosing a versionPositioning and best-fit scenarios for lite / flash / pro
SetupThree steps: enable the service โ†’ create an API token (console or CreateAigcApiToken) โ†’ call the model
Per-key settingsName, model allowlist, IP allowlist, and quota limit
Quick startMinimal calls with the OpenAI SDK and cURL (streaming)
Response fields and usageResponse field reference and token billing details
Error codes, usage lookup, token managementHTTP status and business error codes, console / API usage lookup, and token create / delete / query / update APIs

2. Request Spec Additions โ€‹

  • Auth headers: use either Authorization: Bearer {TOKEN} or x-api-key: {TOKEN}, plus the new X-Request-Id for request tracing.
  • Request parameters: added reasoning_effort (none ~ xhigh), max_completion_tokens, tools, tool_choice, and json_schema for response_format.
  • Media input: audio can be sent as input_audio.data (Base64) + format, and files as file.file_data (Base64) + file.file_name.

3. Corrections โ€‹

ItemBeforeNow
streamFixed to falseBoth true and false supported
File (PDF, etc.) inputPro onlySupported on all three tiers
Per-request limit10 images and videos combinedUp to 10 videos

Sending a video as type: "file" returns 502 + 502003. Always send videos as a video Part.

4. Before You Start โ€‹

  • A new token takes about 1 minute to sync to the gateway; calls made immediately after creation may return 401001.

  • Tokens are not interchangeable between the China and international sites, and each application can hold up to 50.

  • Pro does not accept text-only requests โ€” use Flash or Lite for your first minimal call.

  • Vega VL API docs

  • Setup

  • Error codes

Built with VitePress ยท Deployed on Tencent EdgeOne Pages