Hyper3D - Rodin V2.5

API kılavuzu ve entegrasyon referansı: uç nokta, girdi alanları, fiyatlar, webhook ve hatalar.

Mod

Bu modelin 2 modu var; alanlar, çıktı ve fiyatlar seçili moda göredir. Modu istekte category_id ile seçin (örneklerde hazır). Göndermezseniz girdinize uyan mod, o da yoksa varsayılan mod çalışır.

İstek ve yanıt

POST

https://kolayzeka.com/api/models/hyper3d-rodin-v25/generate

Gövde: { "input": {…alanlar}, "category_id"?: sayı, "webhook_url"?: "https://…" }. Alanlar aşağıda; tanımlı olmayan bir alan 422 döner.

cURL · JSON

curl -X POST https://kolayzeka.com/api/models/hyper3d-rodin-v25/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "Prompt",
    "tier": "Gen-2.5-High",
    "geometry_file_format": "glb",
    "material": "All",
    "quality_mesh_option": "Auto",
    "enable_creative_mode": false,
    "hd_texture": false,
    "texture_delight": false,
    "is_micro": false,
    "TAPose": false,
    "enable_safety_checker": true
  },
  "category_id": 13,
  "webhook_url": "https://your-server.com/hooks/kolayzeka"
}'

Üretim asenkrondur. POST, 202 ve status: "queued" döner; sonuç henüz yoktur. Sonucu GET https://kolayzeka.com/api/generations/{id} ile sorgulayın ya da webhook_url verin (aynı nesne gelir). Durumlar: queued → processing → completed | failed. estimated_seconds bu modun geçmiş ortalama süresidir (null olabilir).

1 · POST yanıtı (202)

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "hyper3d-rodin-v25",
    "output_type": "3d",
    "source": "api",
    "status": "queued",
    "input_data": {
      "prompt": "Prompt",
      "tier": "Gen-2.5-High",
      "geometry_file_format": "glb",
      "material": "All",
      "quality_mesh_option": "Auto",
      "enable_creative_mode": false,
      "hd_texture": false,
      "texture_delight": false,
      "is_micro": false,
      "TAPose": false,
      "enable_safety_checker": true
    },
    "output_data": null,
    "thumbnail_url": null,
    "credit_cost": 358487,
    "duration": null,
    "estimated_seconds": 12,
    "error_message": null,
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:00.000000Z"
  },
  "success": true
}

2 · Tamamlandı (GET /generations/{id} veya webhook)

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "hyper3d-rodin-v25",
    "output_type": "3d",
    "source": "api",
    "status": "completed",
    "input_data": {
      "prompt": "Prompt",
      "tier": "Gen-2.5-High",
      "geometry_file_format": "glb",
      "material": "All",
      "quality_mesh_option": "Auto",
      "enable_creative_mode": false,
      "hd_texture": false,
      "texture_delight": false,
      "is_micro": false,
      "TAPose": false,
      "enable_safety_checker": true
    },
    "output_data": {
      "result": "https://<signed-url>/output.jpg"
    },
    "thumbnail_url": "https://<signed-url>/thumb.jpg",
    "credit_cost": 358487,
    "duration": 4.52,
    "estimated_seconds": 12,
    "error_message": null,
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:05.000000Z"
  },
  "success": true
}

3 · Başarısız

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "hyper3d-rodin-v25",
    "output_type": "3d",
    "source": "api",
    "status": "failed",
    "input_data": {
      "prompt": "Prompt",
      "tier": "Gen-2.5-High",
      "geometry_file_format": "glb",
      "material": "All",
      "quality_mesh_option": "Auto",
      "enable_creative_mode": false,
      "hd_texture": false,
      "texture_delight": false,
      "is_micro": false,
      "TAPose": false,
      "enable_safety_checker": true
    },
    "output_data": null,
    "thumbnail_url": null,
    "credit_cost": 0,
    "duration": null,
    "estimated_seconds": 12,
    "error_message": "Sağlayıcı yoğun, lütfen tekrar deneyin.",
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:00.000000Z"
  },
  "success": true
}

Sonuç output_data.result alanındadır (imzalı URL, süreli: kalıcı tutmak için kendi depolamanıza indirin).
Medya URL'leri imzalıdır ve süresi dolar; eski bir URL için işi tekrar GET edin, taze URL gelir.
Geçmiş: GET https://kolayzeka.com/api/generations (en yeni önce, sayfa başına 20, ?page=).

Fiyat ve teklif

Fiyat kredi cinsindendir ve seçtiğiniz seçeneklere (kalite, boyut, süre, adet…) göre değişir. Varsayılan ayarlarla bu mod ≈ 358487 kredi.

POST

https://kolayzeka.com/api/models/hyper3d-rodin-v25/quote

Çalıştırmadan, tam bu girdinin fiyatı. Token gerekmez; girdiyi üretimdeki gibi doğrular.

cURL

curl -X POST https://kolayzeka.com/api/models/hyper3d-rodin-v25/quote \
  -H "Content-Type: application/json" \
  -d '{"input":{"prompt":"Prompt","tier":"Gen-2.5-High","geometry_file_format":"glb","material":"All","quality_mesh_option":"Auto","enable_creative_mode":false,"hd_texture":false,"texture_delight":false,"is_micro":false,"TAPose":false,"enable_safety_checker":true},"category_id":13}'

Yanıt

{
  "success": true,
  "data": {
    "credits": 358487,
    "basis": "per_generation",
    "exact": true,
    "mode": {
      "category_id": 13,
      "label": "Text to 3D"
    }
  }
}

exact: false: fiyat çıktıya bağlı (ör. token, gerçek süre); teklif tipik değerle hesaplanır.
Kredi, istek kabul edilince teklif tutarı kadar ayrılır. İş bitince gerçek tutara göre fark düşülür ya da iade edilir; iş başarısız olursa tamamı iade edilir. Kesin tutar: sonuçtaki credit_cost.
Bakiye: GET https://kolayzeka.com/api/me → credit_balance. Yetmezse 402 insufficient_credits.

Girdi alanları

input içine gönderilir. Tip etiketi gönderilecek JSON değeridir (string, integer, number, boolean, url, array<url>). Aynı liste makine-okunur olarak GET https://kolayzeka.com/api/ai-models/hyper3d-rodin-v25 yanıtında.

prompt

zorunlu

string

Prompt · A textual prompt to guide model generation. Required for Text-to-3D mode.

tier

isteğe bağlı

string

Tier · Generation tier. Higher tiers produce more detailed meshes. See more info in the [documentation](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers). Selecting Gen-2.5-Minimum will automatically configure to a minimum mode, where 50K Triangle is selected, taking priority over quality_mesh_option.

Kabul edilen değerler:"Gen-2.5-Minimum""Gen-2.5-Extreme-Low""Gen-2.5-Low""Gen-2.5-Medium""Gen-2.5-High""Gen-2.5-Extreme-High"

Varsayılan: "Gen-2.5-High" (gönderilmezse bu kullanılır)

seed

isteğe bağlı

number

Seed · Seed value for randomization, ranging from 0 to 65535. Optional.

geometry_file_format

isteğe bağlı

string

Geometry File Format · Format of the geometry file. Possible values: glb, usdz, fbx, obj, stl. Default is glb.

Kabul edilen değerler:"glb""usdz""fbx""obj""stl"

Varsayılan: "glb" (gönderilmezse bu kullanılır)

material

isteğe bağlı

string

Material · Material type. PBR: physically-based materials with realistic lighting. Shaded: baked lighting with no PBR maps. All: both PBR and Shaded variants. None: geometry only with no textures.

Kabul edilen değerler:"PBR""Shaded""All""None"

Varsayılan: "All" (gönderilmezse bu kullanılır)

quality_mesh_option

isteğe bağlı

string

Quality Mesh Option · Combined quality and mesh type selection. Quad = smooth surfaces, Triangle = detailed geometry. Maps to `mesh_mode` (Quad/Raw) and `quality_override` (face count) on the Hyper3D API. Valid face counts depend on the selected tier. Up to 1M Triangle is supported for tiers Extreme-Low, Low, and Medium. Up to 2M Triangle (as low as 20K Triangle) is supported for tiers High and Extreme-High. Auto option will choose the advised options for each tier: 1. Gen-2.5-Minimum: 50K Triangle 2. Gen-2.5-Extreme-Low: 50K Triangle 3. Gen-2.5-Low: 50K Triangle 4. Gen-2.5-Medium: 500K Triangle 5. Gen-2.5-High: 500K Triangle Gen-2.5-Extreme-High: 1M Triangle.

Kabul edilen değerler:"Auto""4K Quad""8K Quad""18K Quad""50K Quad""100K Quad""200K Quad""2K Triangle""20K Triangle""50K Triangle""150K Triangle""500K Triangle""1M Triangle""2M Triangle"

Varsayılan: "Auto" (gönderilmezse bu kullanılır)

texture_mode

isteğe bağlı

string

Texture Mode · Texture generation quality. When unset, the API picks a default appropriate for the tier.

Kabul edilen değerler:"legacy""extreme-low""low""medium""high"

enable_creative_mode

isteğe bağlı

boolean

Enable Creative Mode · If enabled, the generation will have enhanced generative robustness while ensuring output consistency. This corresponds to `geometry_instruct_mode` being equal to `creative` on the Hyper3D API.