Meshy 7 Retexture

یکپارچه‌سازی

شناسه مدل meshy/v7/retexture

# 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/retexture?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb"
  }'

# 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/retexture?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "model_url": "https://example.com/your-file.glb"
  }),
});
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 = {
    "model_url": "https://example.com/your-file.glb",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v7/retexture", 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/fa/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/retexture",
  "input": {
    "model_url": "https://example.com/your-file.glb"
  }
}

مدل Meshy 7 Retexture (meshy/v7/retexture) را از طریق Doitong API فراخوانی کنید. مستندات عامل‌ها: https://doitong.com/fa/developers/models/meshy/v7/retexture.md

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

{
  "model_url": "https://example.com/your-file.glb"
}

اگر وضعیت پاسخ "queued" یا "running" است، GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20 را تا زمانی که وضعیت "succeeded" شود به‌طور دوره‌ای فراخوانی کنید؛ فایل‌ها در outputs[].url قرار دارند. ارسال POST https://api.doitong.ru/v1/quote/meshy/v7/retexture با همان بدنه، قیمت دقیق را پیش از اجرا برمی‌گرداند.

این درخواست: ⁨‎$۰٫۳۰⁩ ۳۰۰ اعتبار API · ≈ ⁨‎₽۳۱٫۶۴⁩ اجرای آن در این صفحه

دریافت کلید API

Meshy 3D خروجی 4K #3d#3d-to-3d#textures#pbr

نسخه Meshy 7 برای بازبافت‌گذاری سه‌بعدی: ظاهر جدید از یک پرامپت یا تصویر سبک، با خروجی اختیاری PBR

OpenAPI Markdown

Meshy · 3D

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

قیمت

قیمت دقیق

⁨‎$۰٫۳۰⁩برای هر اجرا

۳۰۰ اعتبار API · ≈ ⁨‎₽۳۱٫۶۴⁩

قیمت: از ⁨‎$۰٫۳۰⁩

۱ درخواست × ⁨‎$۰٫۳۰⁩ اجرا · ⁨‎$۰٫۳۰⁩

فقط در صورت موفقیت هزینه دریافت می‌شود و در صورت شکست، مبلغ به‌طور خودکار بازپرداخت می‌شود.

texture_resolution پیش‌فرض 2k

قوانین قیمت‌گذاری

وقتی texture_resolution = 8k: ⁨‎$۰٫۴۵⁩ / درخواست

برای هر درخواست یک‌بار هزینه دریافت می‌شود.

نقطه پایانی برآورد قیمت: POST /quote/{id}

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

texture_resolution پیش‌فرض 2k

گزینه‌های وضوح رنگ پایه 2k (2048)، 4k (4096) و 8k (8192) هستند. انتخاب 8k نقشه‌های PBR را به 4k محدود می‌کند و نقشه emission را حذف می‌کند؛ 8k و 4k فقط با Meshy 6 یا 7 در دسترس‌اند.

model_url •الزامی

منبع مدل سه‌بعدی برای بافت‌دهی، به‌صورت URL عمومی یا URI داده base64 با نوع MIME برابر application/octet-stream. پسوندهای فایل پذیرفته‌شده عبارت‌اند از .glb، .gltf، .obj، .fbx و .stl.

پیشرفته text_style_prompt · image_style_url · enable_original_uv · enable_pbr · enable_safety_checker

text_style_prompt 0 / 600

متن سبک بافت، در نبود image_style_url الزامی و محدود به 600 نویسه.

image_style_url

یک فایل بیندازید، یا

راهنمای دوبعدی بافت‌دهی که در صورت ارائه به‌عنوان image_style_url بر text_style_prompt اولویت دارد. اگر text_style_prompt وجود ندارد این تصویر را ارائه دهید؛ انواع فایل پشتیبانی‌شده .jpg، .jpeg و .png هستند.

POST /run/meshy/v7/retexture?wait=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/retexture?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb"
  }'

# 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/retexture?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "model_url": "https://example.com/your-file.glb"
  }),
});
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 = {
    "model_url": "https://example.com/your-file.glb",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v7/retexture", 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/retexture",
      "input": {
        "model_url": "https://example.com/your-file.glb"
      },
      "wait_seconds": 20
    }
  }
}

اجرای این درخواست

کلید API

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. در این مرورگر به خاطر بسپار دریافت کلید API

درباره Meshy 7 Retexture

یک فایل 3D ارائه‌شده (.glb، .gltf، .obj، .fbx، .stl) را با توضیح متنی حداکثر 600 نویسه یا تصویر سبک 2D تغییر بافت می‌دهد؛ اگر هر دو ارسال شوند، تصویر اولویت دارد. وضوح رنگ پایه 2k، 4k یا 8k است و در 8k نقشه‌های PBR به 4k کاهش می‌یابند و نقشه emission ندارند. `enable_original_uv` را برای حفظ UVهای موجود و `enable_pbr` را برای دریافت نقشه‌های فلزی، زبری و نرمال تنظیم کنید. GLB، قالب‌های دیگر و فایل‌های بافت را برمی‌گرداند.

پارامترها

نامنوع پیش‌فرضمجاز توضیحات

model_urlالزامی

نوعstring

text_style_promptاختیاری

نوعstring | null

≤ ۶۰۰ نویسه

متن سبک بافت، در نبود image_style_url الزامی و محدود به 600 نویسه.

image_style_urlاختیاری

نوعurl · image

texture_resolutionاختیاری

نوعenum

پیش‌فرض2k

2k4k8k

enable_original_uvاختیاری

نوعboolean

پیش‌فرضtrue

با فعال‌کردن این گزینه، UVها حفظ می‌شوند و دوباره تولید نمی‌شوند. اگر برای مدلی بدون نگاشت UV اصلی فعال شود، کیفیت ممکن است کاهش یابد.

enable_pbrاختیاری

نوعboolean

پیش‌فرضfalse

تولید نقشه‌های PBR فلزی، زبری و نرمال را در کنار رنگ پایه کنترل می‌کند.

enable_safety_checkerاختیاری

نوعboolean

پیش‌فرضtrue

کلید بررسی ایمنی پیش‌پردازش: مقدار true بررسی ایمنی ورودی را پیش‌شرط پردازش می‌کند.

الزامی

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/retexture",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "model_url": "https://example.com/your-file.glb"
  },
  "output": {
    "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
        }
      }
    ],
    "text_style_prompt": "red and black chest",
    "image_style_url": "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"
  }
}

فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.

ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.

فیلدهای خروجی

model_glb: object {url, content_type, file_name, file_size}شیء سه‌بعدی با قالب GLB و بافت‌های به‌روزشده.
thumbnail: object {url, content_type, file_name, file_size} | nullتصویر بندانگشتی برای پیش‌نمایش مدل پس از بافت‌دهی مجدد.
model_urls: object {glb, fbx, obj, usdz, blend, stl}پیوندهای مدل سه‌بعدی در قالب‌های مختلف.
texture_urls: array of object {base_color, metallic, normal, roughness}فایل‌های بافت، نمایش‌داده‌شده به‌صورت آرایه‌ای از اشیا.
text_style_prompt: string | nullپرامپت بافت‌دهی استفاده‌شده، در صورت ارائه.
image_style_url: string | nullURL تصویر بافت‌دهی استفاده‌شده، در صورت ارائه.

مدل‌های بیشتر: 3D

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/meshy/v7/retexture.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt

اولین نتیجه شما اینجا قرار می‌گیرد

ساخت درخواست

اجرای این درخواست

درباره Meshy 7 Retexture

پارامترها

خروجی

گونه‌های دیگر Meshy v7

Meshy V7 Image to 3D گونه‌ها: 4

Meshy V7 Multi Image to 3D گونه‌ها: 4

Meshy V7 Text to 3D گونه‌ها: 4

مدل‌های بیشتر: 3D

Meshy 6 Lite Retexture

Meshy 6 Retexture

Meshy Rigging گونه‌ها: 2

Meshy Rigging Multi Animation گونه‌ها: 2