உள்ளடக்கத்திற்குச் செல்க

Tripo3D · Image to 3D

ஒருங்கிணை

மாடல் id tripo3d/tripo/v2.5/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/tripo3d/tripo/v2.5/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"

எடுத்துக்காட்டு போன்ற கோப்புகள்: $0.30 300 API கிரெடிட்கள் · ≈ ₽32.19 இயக்குவதற்கு முன் உங்கள் கோப்புகள் அளவிடப்படும் இந்தப் பக்கத்தில் இயக்குங்கள்

API விசையைப் பெறுக

பாணி முன்னமைவுகள், HD டெக்ஸ்சரிங், குவாட் வெளியீடு மற்றும் சீரமைப்பு விருப்பங்களுடன் படத்திலிருந்து 3D (v2.5)

Tripo · 3D

உங்கள் முதல் முடிவு இங்கே வரும்

கீழே ஒரு கோரிக்கையை உருவாக்கி, உங்கள் API விசையுடன் இயக்குங்கள். வெளியீடுகள் எங்கள் சேமிப்பகத்தில் நகலெடுக்கப்பட்டு, நிரந்தரமாக அல்லது இலவசமாக 7 நாட்கள் வைக்கப்படும்.

கோரிக்கையை உருவாக்கு

மாடல் ஸ்கீமாவிலிருந்து கட்டுப்பாடுகள் உருவாக்கப்படுகின்றன. அவற்றை மாற்றும்போது குறியீடும் விலையும் புதுப்பிக்கப்படும்.

•தேவை image_url
கோப்பை விடுங்கள் அல்லது

மாதிரியை உருவாக்கப் பயன்படுத்தப்படும் படம் URL.

texture இயல்புநிலை standard

மாதிரிக்கான texture அமைப்பு: 'standard' இயல்புநிலை; 'no' textures-ஐ முடக்கும்; 'HD' high-definition textures-ஐ உருவாக்கும்.

Style அமைப்பு; அசல் தோற்றத்தையும் style-ஐயும் பாதுகாக்க இதைக் குறிப்பிடாமல் விடவும்.

மேம்பட்டவை texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
texture_alignment இயல்புநிலை original_image

3D மாதிரிக்கான texture-alignment முன்னுரிமை அமைப்பு; வேறு மதிப்பு வழங்கப்படாவிட்டால் original_image பயன்படுத்தப்படும்.

orientation இயல்புநிலை default

மாதிரி orientation, ஆரம்பத்தில் `default` ஆக அமைக்கப்படும். அசல் படத்துடன் மாதிரியைத் தானாகச் சீரமைக்க `align_image`-ஐத் தேர்ந்தெடுக்கவும்.

வெளியீட்டின் முகப்பு எண்ணிக்கைக்கான உச்சவரம்பு; நீங்கள் வெளிப்படையாக வரம்பைக் குறிப்பிடாவிட்டால், தேவைக்கேற்ப தேர்ந்தெடுக்கப்படும்.

வடிவியல் உருவாக்கத்தைக் கட்டுப்படுத்தும் முழு எண் விதை; இதையே மீண்டும் பயன்படுத்தினால் ஒரே மாதிரியான மாதிரிகள் உருவாகும். குறிப்பிடாவிட்டால் சீரற்ற மதிப்பு தேர்ந்தெடுக்கப்படும்.

Texture-generation seed; integer ஆக வழங்கலாம் அல்லது தவிர்த்தால் சீரற்றதாகத் தேர்ந்தெடுக்கப்படும். ஒரே seed மதிப்புகள் ஒரே textures-ஐ உருவாக்கும்; மாதிரியின் seed-ஐ மாறாமல் வைத்து, மாதிரியின் textures-ஐ மாற்ற texture_seed-ஐ மாற்றவும்.

POST /run/tripo3d/tripo/v2.5/image-to-3d?wait=20 விலை → $0.30
# 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/tripo3d/tripo/v2.5/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"

இந்தக் கோரிக்கையை இயக்கு

உங்கள் key இந்த உலாவியில் மட்டுமே இருக்கும்: அது Doitong API-க்கு மட்டும் அனுப்பப்படும்; Remember-ஐத் தேர்ந்தெடுத்தால் மட்டுமே (localStorage)-ல் சேமிக்கப்படும். API விசையைப் பெறுங்கள்

Tripo3D · Image to 3D பற்றி

ஒற்றை `image_url`-லிருந்து 3D மாதிரியை உருவாக்குகிறது. `texture` no, standard அல்லது HD ஆக இருக்கலாம்; விருப்பமான PBR வெளியீடும் உள்ளது. clay, steampunk, gold அல்லது ancient bronze போன்ற `style` முன்னமைவு முடிவின் பாணியை மாற்றும். பிற கட்டுப்பாடுகளில் `face_limit`, `quad` (FBX-ஐ கட்டாயப்படுத்தும்), `auto_size`, `texture_alignment` மற்றும் மாதிரியைப் படத்துடன் சீரமைக்கும் `orientation` ஆகியவை உள்ளன.

அளவுருக்கள்

நியமப் பெயர் அல்லது நேட்டிவ் பெயர் இரண்டில் ஒன்றை மட்டும் அனுப்பவும். நியமப் பெயர்கள்

பெயர்வகை இயல்புநிலைஅனுமதிக்கப்பட்டது விளக்கம்
seedவிருப்பத்தேர்வு
வகைinteger | null
வடிவியல் உருவாக்கத்தைக் கட்டுப்படுத்தும் முழு எண் விதை; இதையே மீண்டும் பயன்படுத்தினால் ஒரே மாதிரியான மாதிரிகள் உருவாகும். குறிப்பிடாவிட்டால் சீரற்ற மதிப்பு தேர்ந்தெடுக்கப்படும்.
face_limitவிருப்பத்தேர்வு
வகைinteger | null
வெளியீட்டின் முகப்பு எண்ணிக்கைக்கான உச்சவரம்பு; நீங்கள் வெளிப்படையாக வரம்பைக் குறிப்பிடாவிட்டால், தேவைக்கேற்ப தேர்ந்தெடுக்கப்படும்.
pbrவிருப்பத்தேர்வு
வகைboolean | null
இயல்புநிலைfalse
PBR toggle: False என்றால் PBR இல்லாத மாதிரி உருவாகும்; True texture அமைப்பை மீறி அதை True ஆகக் கருதும். PBR இயல்புநிலையில் இயக்கப்பட்டுள்ளது.
textureவிருப்பத்தேர்வு
வகைenum
இயல்புநிலைstandard
nostandardHD
மாதிரிக்கான texture அமைப்பு: 'standard' இயல்புநிலை; 'no' textures-ஐ முடக்கும்; 'HD' high-definition textures-ஐ உருவாக்கும்.
texture_seedவிருப்பத்தேர்வு
வகைinteger | null
Texture-generation seed; integer ஆக வழங்கலாம் அல்லது தவிர்த்தால் சீரற்றதாகத் தேர்ந்தெடுக்கப்படும். ஒரே seed மதிப்புகள் ஒரே textures-ஐ உருவாக்கும்; மாதிரியின் seed-ஐ மாறாமல் வைத்து, மாதிரியின் textures-ஐ மாற்ற texture_seed-ஐ மாற்றவும்.
auto_sizeவிருப்பத்தேர்வு
வகைboolean | null
இயல்புநிலைfalse
இயல்புநிலையில் முடக்கப்பட்ட (False) உண்மையான உலக அளவிடல் switch; மீட்டரைப் பயன்படுத்தி மாதிரியின் பரிமாணங்களைத் தானாகச் சரிசெய்கிறது.
styleவிருப்பத்தேர்வு
வகைenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
Style அமைப்பு; அசல் தோற்றத்தையும் style-ஐயும் பாதுகாக்க இதைக் குறிப்பிடாமல் விடவும்.
quadவிருப்பத்தேர்வு
வகைboolean | null
இயல்புநிலைfalse
நாற்கரப் பயன்முறையை இயக்கினால் FBX வெளியீடு கட்டாயமாகும். quad=True ஆக இருந்து face_limit குறிப்பிடப்படாவிட்டால், face_limit இன் இயல்புநிலை 10000 ஆகும்.
texture_alignmentவிருப்பத்தேர்வு
வகைenum
இயல்புநிலைoriginal_image
original_imagegeometry
3D மாதிரிக்கான texture-alignment முன்னுரிமை அமைப்பு; வேறு மதிப்பு வழங்கப்படாவிட்டால் original_image பயன்படுத்தப்படும்.
orientationவிருப்பத்தேர்வு
வகைenum
இயல்புநிலைdefault
defaultalign_image
மாதிரி orientation, ஆரம்பத்தில் `default` ஆக அமைக்கப்படும். அசல் படத்துடன் மாதிரியைத் தானாகச் சீரமைக்க `align_image`-ஐத் தேர்ந்தெடுக்கவும்.
image_urlதேவை image
வகைurl · image
மாதிரியை உருவாக்கப் பயன்படுத்தப்படும் படம் URL.
தேவை நியமப் பெயர், இதுவும் ஏற்கப்படும்

கோப்பு அளவுருக்கள் பொதுவான https:// URL, 10 MB வரையிலான data: URI அல்லது பதிவேற்றத்தின் file_url-ஐ ஏற்கும். கோப்புகள்

வெளியீடு

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/tripo/v2.5/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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "task_id": "string",
    "model_mesh": {
      "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
    },
    "base_model": {
      "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
    },
    "pbr_model": {
      "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
    },
    "rendered_image": {
      "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
    }
  },
  "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= மூலம் இலவசமாக 7 நாட்கள் வைக்கப்படும்.
ஒவ்வொரு மாடலிலும் ஒரே வடிவம்படங்கள், வீடியோ மற்றும் ஆடியோ ஆகிய அனைத்திற்குமான type, url, content_type, width, height மற்றும் duration. output என்பது மாதிரியின் சொந்த முடிவு பொருளாகும்.
வெளியீட்டின் புலங்கள்
task_id
string3D மாதிரியை உருவாக்குவதற்கான task identifier.
model_mesh
object {url, content_type, file_name, file_size} | nullமாதிரி வெளியீடு.
base_model
object {url, content_type, file_name, file_size} | nullBase-model வெளியீடு.
pbr_model
object {url, content_type, file_name, file_size} | nullPBR-model வெளியீடு.
rendered_image
object {url, content_type, file_name, file_size} | nullமாதிரியின் preview-ஐக் காட்டும் படம்.

மேலும் மாதிரிகள்: படத்திலிருந்து 3D-க்கு

AI ஏஜெண்டுகளுக்கு: இந்தப் பக்கம் Markdown வடிவில் இங்கே உள்ளது https://doitong.com/ta/developers/models/tripo3d/tripo/v2.5/image-to-3d.md. அனைத்து மாடல்களும் வழிகாட்டிகளும்: https://doitong.com/developers/llms.txt