curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "meshy/v6/image-to-3d",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "topology": "triangle",
    "target_polycount": 30000,
    "should_remesh": true,
    "symmetry_mode": "auto",
    "should_texture": true,
    "pose_mode": "",
    "rigging_height_meters": 1.7,
    "animation_action_id": 1001,
    "enable_safety_checker": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

"Request timeout"

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "meshy/v6/image-to-3d",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "topology": "triangle",
    "target_polycount": 30000,
    "should_remesh": true,
    "symmetry_mode": "auto",
    "should_texture": true,
    "pose_mode": "",
    "rigging_height_meters": 1.7,
    "animation_action_id": 1001,
    "enable_safety_checker": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

"Request timeout"

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Submit the request with VIDGO_API_KEY. A task_id is returned immediately. Keep it until the task reaches finished or failed.
Use Query Task Status to retrieve the result. If you provide a callback_url, Vidgo sends the result to your webhook when the task finishes or fails.

Meshy 6 Image to 3D

Turn a reference image into a textured 3D asset with Meshy 6, with remeshing, material controls, and optional rigging and animation.

Available Models

meshy/v6/image-to-3d - Generate a 3D model from an image.

Output Options

Target Polycount

target_polycount: Optional. Set the target polygon count. Integer. Default: 30000.

Topology

topology: Optional. Select the mesh topology. Accepted values: quad, triangle. Default: triangle.

Key Features

Generate a 3D model from an image.
Accepts exactly 1 image in image_urls.
Retrieve model assets and available previews or supporting files from the task result.
Optionally add textures, rigging, and animation.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Place the parameters listed below inside input. Use publicly accessible HTTP(S) URLs for images and texture references.

enable_animation: true requires enable_rigging: true.

Image URLs

image_urls: Required. Provide publicly accessible image URLs. Supply exactly 1 item. Each item must be an HTTP(S) URL.

Remeshing

should_remesh: Optional. Control remeshing. Use true or false. Default: true.

Symmetry Mode

symmetry_mode: Optional. Select how symmetry is handled. Accepted values: off, auto, on. Default: auto.

Textures

should_texture: Optional. Control texture generation. Use true or false. Default: true.

PBR

enable_pbr: Optional. Control physically based rendering (PBR) materials. Use true or false.

Pose Mode

pose_mode: Optional. Select a pose, or send an empty string for no pose selection. Accepted values: a-pose, t-pose, "". Default: "".

Texture Prompt

texture_prompt: Optional. Describe the desired texture.

Texture Image URL

texture_image_url: Optional. Provide a texture reference URL. Use a publicly accessible HTTP(S) URL.

Rigging

enable_rigging: Optional. Request rigging for the generated model. Use true or false.

Rigging Height

rigging_height_meters: Optional. Set the rigging height in meters. Number. Default: 1.7.

Animation

enable_animation: Optional. Request animation; rigging must also be enabled. Use true or false.

Animation Action ID

animation_action_id: Optional. Select the animation action. Integer. Default: 1001.

Safety Checker

enable_safety_checker: Optional. Control safety checking. Use true or false. Default: true.

Output Files

Read every item in the returned files array.
Model assets use file_type: "3d"; previews use file_type: "image".
Read supporting files with file_type: "other" alongside the returned textures, animation assets, and file metadata.

Authorizations

Authorization

string

header

required

Use VIDGO_API_KEY.

Body

application/json

Place model and optional callback_url at the request root, and generation parameters inside input.

model

string

required

Example:

"meshy/v6/image-to-3d"

input

object

required

Show child attributes

callback_url

string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code

enum<integer>

required

Available options:

200

data

object

required

Show child attributes

Overview

Chat Series

Image Series

Video Series

Music Series

3D Series

File Management

Task Management

Account Management

Meshy 6 Image to 3D

Meshy 6 Image to 3D

Available Models

Output Options

Target Polycount

Topology

Key Features

Advanced Parameters

Image URLs

Remeshing

Symmetry Mode

Textures

PBR

Pose Mode

Texture Prompt

Texture Image URL

Rigging

Rigging Height

Animation

Animation Action ID

Safety Checker

Output Files

Authorizations

Body

Response

​Meshy 6 Image to 3D

​Available Models

​Output Options

​Target Polycount

​Topology

​Key Features

​Advanced Parameters

​Image URLs

​Remeshing

​Symmetry Mode

​Textures

​PBR

​Pose Mode

​Texture Prompt

​Texture Image URL

​Rigging

​Rigging Height

​Animation

​Animation Action ID

​Safety Checker

​Output Files

Authorizations

Body

Response

Meshy 6 Image to 3D

Available Models

Output Options

Target Polycount

Topology

Key Features

Advanced Parameters

Image URLs

Remeshing

Symmetry Mode

Textures

PBR

Pose Mode

Texture Prompt

Texture Image URL

Rigging

Rigging Height

Animation

Animation Action ID

Safety Checker

Output Files