Hyper3D - Rodin V2.5 - Text to 3D - Fast

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-text-to-3d-fast/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-text-to-3d-fast/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "Prompt",
    "tier": "Gen-2.5-Extreme-Low",
    "geometry_file_format": "glb",
    "material": "Shaded",
    "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-text-to-3d-fast",
    "output_type": "3d",
    "source": "api",
    "status": "queued",
    "input_data": {
      "prompt": "Prompt",
      "tier": "Gen-2.5-Extreme-Low",
      "geometry_file_format": "glb",
      "material": "Shaded",
      "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": 89622,
    "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-text-to-3d-fast",
    "output_type": "3d",
    "source": "api",
    "status": "completed",
    "input_data": {
      "prompt": "Prompt",
      "tier": "Gen-2.5-Extreme-Low",
      "geometry_file_format": "glb",
      "material": "Shaded",
      "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": 89622,
    "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-text-to-3d-fast",
    "output_type": "3d",
    "source": "api",
    "status": "failed",
    "input_data": {
      "prompt": "Prompt",
      "tier": "Gen-2.5-Extreme-Low",
      "geometry_file_format": "glb",
      "material": "Shaded",
      "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 ≈ 89622 kredi.

POST

https://kolayzeka.com/api/models/hyper3d-rodin-v25-text-to-3d-fast/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-text-to-3d-fast/quote \
  -H "Content-Type: application/json" \
  -d '{"input":{"prompt":"Prompt","tier":"Gen-2.5-Extreme-Low","geometry_file_format":"glb","material":"Shaded","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": 89622,
    "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-text-to-3d-fast 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. 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"

Varsayılan: "Gen-2.5-Extreme-Low" (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: "Shaded" (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 Minimum, Extreme-Low, Low. For fast endpoint, this limit is up to 20K, primarily for prototyping and testing. For generating higher quality meshes, use the standard endpoint. Auto option will choose the advised options for each tier: 1. Gen-2.5-Minimum: 20K Triangle 2. Gen-2.5-Extreme-Low: 20K Triangle 3. Gen-2.5-Low: 20K Triangle

Kabul edilen değerler:"Auto""1K Quad""4K Quad""8K Quad""18K Quad""20K Quad""2K Triangle""4K Triangle""8K Triangle""10K Triangle""20K 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.