Hızlı başlangıç

Meshy REST API kullanarak ilk 3D modeliniz için dört adım.

1API anahtarınızı alın

Hesap ayarlarından bir API anahtarı oluşturun — bu ekran sonrasında anahtarı tekrar görüntüleyemeyeceksiniz, bu yüzden güvenli bir yerde saklayın. Her istek, Authorization başlığındaki Bearer token ile kimlik doğrular — Kimlik Doğrulama sayfasına bakın.

2İlk Görselden 3D'ye isteğinizi yapın

Anahtarınızı dışa aktarın, ardından Görselden 3D'ye ile ilk görevinizi oluşturun. Bunun yerine bir metin promptu veya birden fazla fotoğrafla mı çalışıyorsunuz? Metinden 3D'ye veya Çoklu görselden 3D'ye bölümüne bakın.

export MESHY_API_KEY="<api-anahtarınız>"

Aşağıdaki her örnekte bu fotoğraf kullanılmıştır — başka bir şey denemek için kendi image_url'nizi ekleyin.

Copy image URL

curl https://api.meshy.ai/openapi/v1/image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${MESHY_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://docs.meshy.ai/images/api/quick-start/source-photo.webp"
  }'

3Görev durumunu kontrol edin

İstekler anında bir görev kimliği döndürür. Aşağıdaki <task_id> ile URL'yi adım 2'de döndürülen kimlikle değiştirerek status SUCCEEDED olana kadar aynı uç noktayı sürekli sorgulayın.

curl https://api.meshy.ai/openapi/v1/image-to-3d/<task_id> \
  -H "Authorization: Bearer ${MESHY_API_KEY}"

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "status": "SUCCEEDED",
  "progress": 100,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "task_error": {
    "message": ""
  }
}

4Modelinizi indirin

Yanıttaki model_urls'den modeli alın. Her format (GLB, FBX, OBJ, USDZ, STL) imzalanmış, zaman sınırlı bir URL'dir — ya da komut satırını atlayarak doğrudan tarayıcınızın adres çubuğuna yapıştırarak indirin.

curl -L "<model_urls.glb from the response above>" -o model.glb

Hepsini bir araya getir

Tüm işlemi gerçekleştiren bir betik tercih edenlerden misiniz — oluştur, sorgula, indir?

import axios from 'axios';
import fs from 'fs';

const headers = { Authorization: `Bearer ${process.env.MESHY_API_KEY}` };
const imageUrl = 'https://docs.meshy.ai/images/api/quick-start/source-photo.webp';

// 1. Görevi oluştur
const { data: created } = await axios.post(
  'https://api.meshy.ai/openapi/v1/image-to-3d',
  { image_url: imageUrl },
  { headers },
);
const taskId = created.result;

// 2. Bitene kadar sorgula
let task;
while (true) {
  const { data } = await axios.get(`https://api.meshy.ai/openapi/v1/image-to-3d/${taskId}`, { headers });
  task = data;
  if (task.status === 'SUCCEEDED' || task.status === 'FAILED') break;
  await new Promise((resolve) => setTimeout(resolve, 5000));
}

// 3. Sonucu indir
const { data: model } = await axios.get(task.model_urls.glb, { responseType: 'arraybuffer' });
fs.writeFileSync('model.glb', model);
console.log('model.glb kaydedildi');

Yaygın iş akışlarını keşfedin

Sonraki adımlar

• Bir arayüz mü tercih ediyorsunuz? API Playground deneyin — bir istek yapılandırın, çalıştırın ve üretilen kodu kopyalayın.
• Her uç nokta için tam API referansını gözden geçirin.
• Üretime geçmeden önce Fiyatlandırma, Hız Sınırları ve Hatalar'a göz atın.
• Güncellemeler ve hata düzeltmeleri için Değişiklik Günlüğünü izleyin.
• Geri bildiriminiz mi var yoksa sorun mu yaşıyorsunuz? Discord topluluğumuza katılın — sizden haber almak isteriz!