Meshy V7 Image to 3D

Integrar

ID do modelo meshy/v7/image-to-3d

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/v7/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/meshy/v7/image-to-3d?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v7/image-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/pt-BR/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "meshy/v7/image-to-3d",
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }
}

Chame o modelo Meshy V7 Image to 3D (meshy/v7/image-to-3d) por meio da Doitong API. Documentação para agentes: https://doitong.com/pt-BR/developers/models/meshy/v7/image-to-3d.md

POST https://api.doitong.ru/v1/run/meshy/v7/image-to-3d?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}

Se o status da resposta for "queued" ou "running", consulte GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 repetidamente até que seja "succeeded"; os arquivos estão em outputs[].url. POST https://api.doitong.ru/v1/quote/meshy/v7/image-to-3d com o mesmo corpo retorna o preço exato antes da execução.

Arquivos como o exemplo: $ 1,20 1.200 créditos de API · ≈ ₽ 129,10 seus arquivos são medidos antes da execução Executar nesta página

Obter chave de API

Meshy Imagem para 3D #stylized#transform

Transforma uma única imagem em uma malha 3D com opção de geometria 2k, PBR, rigging e animação opcionais

OpenAPI Markdown

Meshy · 3D

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

image •obrigatório image_url

Solte um arquivo ou

Forneça a imagem de origem para criação 3D por URL ou URI de dados base64, usando .jpg, .jpeg, .png, AVIF ou HEIF. A conversão automática processa as entradas AVIF e HEIF.

geometry_resolution

Resolução da geometria da malha; as opções Meshy-7 compatíveis são standard e 2k.

Avançado texture_prompt · texture_image_url · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · should_remesh · enable_pbr · is_a_t_pose · enable_safety_checker · ultra_mode

texture_prompt 0 / 600

Instruções de texto que direcionam a geração de texturas.

texture_image_url

Solte um arquivo ou

Imagem de referência 2D que direciona a geração de texturas.

model_type padrão standard

Modo de malha 3D: escolha 'lowpoly' para um resultado low-poly otimizado para polígonos mais limpos; nesse modo, o Meshy ignora topology, target_polycount e should_remesh. Para um resultado convencional de alto detalhe, escolha 'standard', ou escolha 'smart-topology' para usar Meshy-T2 e obter partes limpas geradas separadamente desde o início.

topology padrão triangle

Escolha da topologia do modelo entre Triangle, para detalhes geométricos, e Quad, para suavidade da superfície.

symmetry_mode padrão auto

Escolha se a geração do modelo força a simetria com On, a omite com Off ou decide automaticamente com Auto.

pose_mode padrão

Deixe a string vazia para não especificar a pose do modelo gerado, ou solicite uma pose A com 'a-pose' ou uma pose T com 't-pose'.

target_polycount padrão 30000

Meta de quantidade de polígonos, limitada a 15,000 quando model_type é 'smart-topology'. Omitir a meta nesse modo seleciona o valor padrão inferior do Meshy, 4,000.

rigging_height_meters padrão 1.7

Forneça uma altura estimada do personagem em metros quando enable_rigging for true; caso contrário, esse valor não tem efeito.

animation_action_id padrão 92

ID de predefinição de animação da biblioteca Meshy, com ações disponíveis em https://docs.meshy.ai/en/api/animation-library. A validação e o uso aplicam-se somente quando enable_animation é true: valores fora de [0, 696] são rejeitados com 422, e "Idle" corresponde a `0`.

POST /run/meshy/v7/image-to-3d?wait=20 cotação → $ 1,20

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/v7/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/meshy/v7/image-to-3d?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v7/image-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "meshy/v7/image-to-3d",
      "input": {
        "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
      },
      "wait_seconds": 20
    }
  }
}

Executar esta solicitação

Chave de API

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Lembrar neste navegador Obter uma chave de API

Sobre Meshy V7 Image to 3D

Cria um modelo 3D a partir de uma imagem em `image_url` (JPG, PNG, AVIF ou HEIF). `model_type` seleciona standard, lowpoly ou smart-topology, e `target_polycount` aceita de 100 a 300000. `geometry_resolution` oferece standard ou 2k. A texturização pode ser desativada com `should_texture`, e mapas PBR, um modo de pose, rigging humanoide e uma predefinição de animação são opcionais.

Parâmetros

Envie o nome canônico ou o nome nativo, não ambos. Nomes canônicos

NomeTipo PadrãoPermitido Descrição

image_urlobrigatório image

Tipourl · image

Forneça a imagem de origem para criação 3D por URL ou URI de dados base64, usando .jpg, .jpeg, .png, AVIF ou HEIF. A conversão automática processa as entradas AVIF e HEIF.

model_typeopcional

Tipoenum

Padrãostandard

standardlowpolysmart-topology

topologyopcional

Tipoenum

Padrãotriangle

quadtriangle

Escolha da topologia do modelo entre Triangle, para detalhes geométricos, e Quad, para suavidade da superfície.

target_polycountopcional

Tipointeger

Padrão30000

100 – 300.000

Meta de quantidade de polígonos, limitada a 15,000 quando model_type é 'smart-topology'. Omitir a meta nesse modo seleciona o valor padrão inferior do Meshy, 4,000.

symmetry_modeopcional

Tipoenum

Padrãoauto

offautoon

Escolha se a geração do modelo força a simetria com On, a omite com Off ou decide automaticamente com Auto.

should_remeshopcional

Tipoboolean

Padrãotrue

Ativa ou desativa a etapa de remalhagem.

should_textureopcional

Tipoboolean

Padrãotrue

Ativa ou desativa a geração de texturas.

enable_pbropcional

Tipoboolean

Padrãofalse

Adiciona mapas PBR metálico, rugosidade e normal junto à cor base.

is_a_t_poseopcional

Tipoboolean

Padrãofalse

Opção de geração em pose T ativada por true; obsoleta e substituída por pose_mode.

pose_modeopcional

Tipoenum

Padrão

a-poset-pose

Deixe a string vazia para não especificar a pose do modelo gerado, ou solicite uma pose A com 'a-pose' ou uma pose T com 't-pose'.

texture_promptopcional

Tipostring | null

≤ 600 caracteres

Instruções de texto que direcionam a geração de texturas.

texture_image_urlopcional

Tipourl · image

Imagem de referência 2D que direciona a geração de texturas.

enable_riggingopcional

Tipoboolean

Padrãofalse

Rigging humanoide automático, mais eficaz para modelos humanoides cujos membros sejam claramente distinguíveis. Ativá-lo aplica rigging ao modelo gerado e fornece animações básicas de caminhada e corrida.

rigging_height_metersopcional

Tiponumber

Padrão1.7

> 0

Forneça uma altura estimada do personagem em metros quando enable_rigging for true; caso contrário, esse valor não tem efeito.

enable_animationopcional

Tipoboolean

Padrãofalse

Indica se o modelo com rigging recebe uma animação predefinida, o que exige que enable_rigging seja true.

animation_action_idopcional

Tipointeger

Padrão92

enable_safety_checkeropcional

Tipoboolean

Padrãotrue

Opção de verificação de segurança do pré-processamento: true torna a verificação de segurança da entrada um pré-requisito para o processamento.

geometry_resolutionopcional

Tipoenum

standard2k

Resolução da geometria da malha; as opções Meshy-7 compatíveis são standard e 2k.

ultra_modeopcional

Tipoboolean

Padrãofalse

Opção obsoleta substituída por geometry_resolution, que prevalece se ambas forem fornecidas; use geometry_resolution='2k' em vez disso.

obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/image-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1200,
    "usd": "1.20",
    "charged": 1200,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "animation_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "animation_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "thumbnail": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "obj": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "usdz": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "blend": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "stl": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "texture_urls": [
      {
        "base_color": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "metallic": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "normal": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "roughness": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        }
      }
    ],
    "seed": 42,
    "rigged_character_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "rigged_character_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "basic_animations": {
      "walking_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "rig_task_id": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}

Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.

Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.

Campos da saída

animation_glb: object {url, content_type, file_name, file_size} | nullResultado da animação contendo o modelo 3D como GLB; a resposta omite esse resultado, a menos que enable_animation seja true.
animation_fbx: object {url, content_type, file_name, file_size} | nullResultado da animação contendo o modelo 3D como FBX; a resposta omite esse resultado, a menos que enable_animation seja true.
model_glb: object {url, content_type, file_name, file_size}Arquivo GLB contendo o objeto 3D gerado.
thumbnail: object {url, content_type, file_name, file_size} | nullMiniatura mostrando uma prévia do modelo gerado.
model_urls: object {glb, fbx, obj, usdz, blend, stl}Links para o modelo 3D em vários formatos.
texture_urls: array of object {base_color, metallic, normal, roughness}Objetos de arquivo de textura em um array estruturado para corresponder à API do Meshy.
seed: integer | nullSeed de geração, quando disponível.
rigged_character_glb: object {url, content_type, file_name, file_size} | nullResultado do rigging entregue como arquivo de personagem GLB; ausente da resposta, a menos que enable_rigging seja true.
rigged_character_fbx: object {url, content_type, file_name, file_size} | nullResultado do rigging entregue como arquivo de personagem FBX; ausente da resposta, a menos que enable_rigging seja true.
basic_animations: object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimações básicas de caminhada e corrida, incluídas somente se enable_rigging for true.
rig_task_id: string | nullIdentificador da tarefa de rigging; incluído somente se enable_rigging for true.

Mais modelos: Imagem para 3D

Para agentes de IA: esta página em Markdown está em https://doitong.com/pt-BR/developers/models/meshy/v7/image-to-3d.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt

Seu primeiro resultado aparecerá aqui

Criar uma solicitação

Executar esta solicitação

Sobre Meshy V7 Image to 3D

Parâmetros

Saída

Outras variantes de Meshy v7

Meshy V7 Multi Image to 3D Variantes: 4

Meshy V7 Text to 3D Variantes: 4

Meshy 7 Retexture Variantes: 4

Mais modelos: Imagem para 3D

Meshy 6 Preview · Image to 3D Variantes: 2

Meshy 6 · Image to 3D Variantes: 2

Meshy 7.1 Image to 3D Variantes: 3

Meshy 7.1 Multi Image to 3D Variantes: 3