# Animasyon Yeniden Hedefleme
> **POST** `/v3/animations/retarget`
Rig'lenmiş bir 3D modele önceden ayarlanmış bir animasyon uygulayın.
## İstek Parametreleri
### Başlıkları Talep Et
| Parametre | Tür | Gerekli | Varsayılan | Açıklama |
| :-: | :-: | :-: | :-: | :-: |
| Content-Type | dize | Evet | — | `application/json` |
| Authorization | dize | Evet | — | `Bearer {api_key}` |
### Talep Gövdesi
| Parametre | Tür | Gerekli | Varsayılan | Açıklama |
| :-: | :-: | :-: | :-: | :-: |
| input | dize | Evet | — | `task_` ile başlayan, hileli modelin task_id'si |
| animation | dize | Şartlı olarak gerekli | — | Tek ön ayarlı animasyon tanımlayıcı. `animations` ile karşılıklı olarak özel. Mevcut değerler için aşağıdaki önceden ayarlanmış animasyon listesine bakın |
| animations | dize[] | Şartlı olarak gerekli | — | Birden çok önceden ayarlanmış animasyon tanımlayıcısının listesi; en fazla 5. 5'ten fazla gönderilirse hata döndürülür. `animation` ile birlikte kullanılamaz |
| out_format | dize | Hayır | `glb` | Çıkış formatı. Olası değerler: `glb`, `fbx` |
| bake_animation | boolean | Hayır | — | **Kullanımdan kaldırıldı ve yok sayılır.** Yalnızca geriye dönük uyumluluk için kabul edilir; yeni entegrasyonlar bu parametreyi göndermemelidir |
| export_with_geometry | boolean | Hayır | `true` | Geometri dahil dışa aktarma |
| animate_in_place | boolean | Hayır | `false` | Animasyonu yer değiştirmeden yerinde oynatın |
### Önceden Ayarlanmış Animasyon Listesi
Kullanılabilir ön ayarlar, yukarı akış `POST /v3/animations/rig` adımında kullanılan **rigging modeli sürümüne** bağlıdır.
#### Rigging v2.0 / v2.5 / v3.0 — Tüm rigging türleri
| Animasyon Tanımlayıcı | Açıklama |
| :-: | :-: |
| `preset:idle` | Boşta |
| `preset:walk` | Yürümek |
| `preset:run` | Çalıştır |
| `preset:dive` | Dalış |
| `preset:climb` | Tırmanış |
| `preset:jump` | Atla |
| `preset:slash` | Eğik çizgi |
| `preset:shoot` | Ateş et |
| `preset:hurt` | Acı |
| `preset:fall` | Güz |
| `preset:turn` | Dönüş |
| `preset:quadruped:walk` | Dört ayaklı yürüyüş |
| `preset:hexapod:walk` | Heksapod yürüyüşü |
| `preset:octopod:walk` | Ahtapot yürüyüşü |
| `preset:serpentine:march` | Yılan gibi hareket |
| `preset:aquatic:march` | Suda hareket |
#### Rig v1.0 — Yalnızca iki ayaklı (90'dan fazla ön ayar)
Yalnızca yukarı akış rigging görevinde `v1.0-20240301` kullanıldığında kullanılabilir. Duyguları, sporu, dövüşü, dansı ve günlük eylemleri kapsar.
<details>
<summary><strong>İki ayaklı ön ayar listesinin tamamını genişletmek için tıklayın</strong></summary>
| Animasyon Tanımlayıcı | Kategori |
| :-: | :-: |
| `preset:biped:idle` | Temel |
| `preset:biped:walk` | Temel |
| `preset:biped:run` | Temel |
| `preset:biped:run_upstairs` | Temel |
| `preset:biped:turn` | Temel |
| `preset:biped:jump` | Temel |
| `preset:biped:jump_down` | Temel |
| `preset:biped:jump_rope_01` | Temel |
| `preset:biped:jump_rope_02` | Temel |
| `preset:biped:fall` | Temel |
| `preset:biped:climb` | Temel |
| `preset:biped:dive` | Temel |
| `preset:biped:swim` | Temel |
| `preset:biped:surf` | Temel |
| `preset:biped:flip` | Temel |
| `preset:biped:sit` | Temel |
| `preset:biped:standing_relax` | Temel |
| `preset:biped:look_around` | Temel |
| `preset:biped:wait` | Temel |
| `preset:biped:swagger` | Temel |
| `preset:biped:dance_01` | Dans |
| `preset:biped:dance_02` | Dans |
| `preset:biped:dance_03` | Dans |
| `preset:biped:dance_04` | Dans |
| `preset:biped:dance_05` | Dans |
| `preset:biped:dance_06` | Dans |
| `preset:biped:freaky` | Dans |
| `preset:biped:sing_01` | Performans |
| `preset:biped:sing_02` | Performans |
| `preset:biped:sing_03` | Performans |
| `preset:biped:sing_04` | Performans |
| `preset:biped:cheer` | Performans |
| `preset:biped:clap` | Duygu |
| `preset:biped:bow` | Duygu |
| `preset:biped:greet_01` | Duygu |
| `preset:biped:greet_02` | Duygu |
| `preset:biped:greet_03` | Duygu |
| `preset:biped:greet_04` | Duygu |
| `preset:biped:wave_goodbye_01` | Duygu |
| `preset:biped:wave_goodbye_02` | Duygu |
| `preset:biped:agree` | Duygu |
| `preset:biped:heart_pose` | Duygu |
| `preset:biped:hug` | Duygu |
| `preset:biped:fold_arms` | Duygu |
| `preset:biped:laugh_01` | Duygu |
| `preset:biped:laugh_02` | Duygu |
| `preset:biped:cry` | Duygu |
| `preset:biped:sob` | Duygu |
| `preset:biped:afraid` | Duygu |
| `preset:biped:frightened` | Duygu |
| `preset:biped:scared_01` | Duygu |
| `preset:biped:scared_02` | Duygu |
| `preset:biped:angry_01` | Duygu |
| `preset:biped:angry_02` | Duygu |
| `preset:biped:angry_03` | Duygu |
| `preset:biped:depressed` | Duygu |
| `preset:biped:frustrated_01` | Duygu |
| `preset:biped:frustrated_02` | Duygu |
| `preset:biped:complain_01` | Duygu |
| `preset:biped:complain_02` | Duygu |
| `preset:biped:victory_celebration` | Duygu |
| `preset:biped:defeat_02` | Duygu |
| `preset:biped:defeat_03` | Duygu |
| `preset:biped:scratch` | Günlük |
| `preset:biped:make_a_call_01` | Günlük |
| `preset:biped:make_a_call_02` | Günlük |
| `preset:biped:play_mobile_game` | Günlük |
| `preset:biped:play_video_game` | Günlük |
| `preset:biped:dig` | Günlük |
| `preset:biped:chop` | Günlük |
| `preset:biped:shovel` | Günlük |
| `preset:biped:lift_heavy` | Günlük |
| `preset:biped:warm_up` | Spor |
| `preset:biped:press-up` | Spor |
| `preset:biped:cross_body_crunch` | Spor |
| `preset:biped:basketball_shot` | Spor |
| `preset:biped:crossover_dribble` | Spor |
| `preset:biped:dribble` | Spor |
| `preset:biped:pitch_baseball` | Spor |
| `preset:biped:golf` | Spor |
| `preset:biped:volleyball` | Spor |
| `preset:biped:football_catch` | Spor |
| `preset:biped:football_save` | Spor |
| `preset:biped:football_pass` | Spor |
| `preset:biped:box_01` | Dövüş |
| `preset:biped:box_02` | Dövüş |
| `preset:biped:box_03` | Dövüş |
| `preset:biped:front_kick_01` | Dövüş |
| `preset:biped:front_kick_02` | Dövüş |
| `preset:biped:slash` | Dövüş |
| `preset:biped:shoot` | Dövüş |
| `preset:biped:fire` | Dövüş |
| `preset:biped:cast_a_spell` | Dövüş |
| `preset:biped:hurt` | Dövüş |
| `preset:biped:hit_to_body_01` | Dövüş |
| `preset:biped:hit_to_body_02` | Dövüş |
| `preset:biped:hit_to_head` | Dövüş |
| `preset:biped:hit_to_side` | Dövüş |
| `preset:biped:hit_to_stomach` | Dövüş |
| `preset:biped:flee_01` | Dövüş |
| `preset:biped:flee_02` | Dövüş |
</details>
## Örnekler İste
### curl
```bash
curl -X POST https://openapi.tripo3d.ai/v3/animations/retarget \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{
"input": "task_abc123",
"animation": "preset:walk",
"out_format": "glb",
"animate_in_place": false
}'
```
### Python
```python
import requests
url = "https://openapi.tripo3d.ai/v3/animations/retarget"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
}
payload = {
"input": "task_abc123",
"animation": "preset:walk",
"out_format": "glb",
"animate_in_place": False
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
```
### JavaScript
```javascript
const url = "https://openapi.tripo3d.ai/v3/animations/retarget";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {api_key}"
},
body: JSON.stringify({
input: "task_abc123",
animation: "preset:walk",
out_format: "glb",
animate_in_place: false
})
});
const data = await response.json();
console.log(data);
```
## Yanıt
### Başarılı Yanıt
```json
{
"code": 0,
"data": {
"task_id": "task_def456"
}
}
```
### Yanıt Alanları
| Parametre | Tür | Açıklama |
| :-: | :-: | :-: |
| code | tamsayı | Durum kodu. `0` başarıyı gösterir |
| data.task_id | dize | Animasyon yeniden hedefleme ilerlemesini ve sonucunu yoklamak için kullanılan benzersiz görev tanımlayıcı |
## Hata Kodları
| HTTP Durum Kodu | Hata Kodu | Açıklama | Tavsiye |
| :-: | :-: | :-: | :-: |
| 429 | 2000 | Üretim sınırı aşıldı | İstek oranını azaltın ve daha sonra yeniden deneyin |
| 400 | 2002 | Desteklenmeyen istek parametresi | İstek gövdesi parametre adlarını ve değer aralıklarını kontrol edin |
| 400 | 2006 | Geçersiz giriş kaynağı görev türü | task_id'nin hileli bir modele karşılık geldiğini doğrulayın |
| 400 | 2007 | Kaynak görev durumu başarılı değil | Animasyon yeniden hedeflemeye başlamadan önce kaynak görevin tamamlanmasını bekleyin |
| 403 | 2010 | Yetersiz kredi | Kredileri şarj edin ve yeniden deneyin |
Animasyon Yeniden Hedefleme
POST/v3/animations/retarget
Rig’lenmiş bir 3D modele önceden ayarlanmış bir animasyon uygulayın.
İstek Parametreleri
Başlıkları Talep Et
Parametre
Tür
Gerekli
Varsayılan
Açıklama
Content-Type
dize
Evet
—
application/json
Authorization
dize
Evet
—
Bearer {api_key}
Talep Gövdesi
Parametre
Tür
Gerekli
Varsayılan
Açıklama
input
dize
Evet
—
task_ ile başlayan, hileli modelin task_id’si
animation
dize
Şartlı olarak gerekli
—
Tek ön ayarlı animasyon tanımlayıcı. animations ile karşılıklı olarak özel. Mevcut değerler için aşağıdaki önceden ayarlanmış animasyon listesine bakın
animations
dize[]
Şartlı olarak gerekli
—
Birden çok önceden ayarlanmış animasyon tanımlayıcısının listesi; en fazla 5. 5’ten fazla gönderilirse hata döndürülür. animation ile birlikte kullanılamaz
out_format
dize
Hayır
glb
Çıkış formatı. Olası değerler: glb, fbx
bake_animation
boolean
Hayır
—
Kullanımdan kaldırıldı ve yok sayılır. Yalnızca geriye dönük uyumluluk için kabul edilir; yeni entegrasyonlar bu parametreyi göndermemelidir
export_with_geometry
boolean
Hayır
true
Geometri dahil dışa aktarma
animate_in_place
boolean
Hayır
false
Animasyonu yer değiştirmeden yerinde oynatın
Önceden Ayarlanmış Animasyon Listesi
Kullanılabilir ön ayarlar, yukarı akış POST /v3/animations/rig adımında kullanılan rigging modeli sürümüne bağlıdır.
Rigging v2.0 / v2.5 / v3.0 — Tüm rigging türleri
Animasyon Tanımlayıcı
Açıklama
preset:idle
Boşta
preset:walk
Yürümek
preset:run
Çalıştır
preset:dive
Dalış
preset:climb
Tırmanış
preset:jump
Atla
preset:slash
Eğik çizgi
preset:shoot
Ateş et
preset:hurt
Acı
preset:fall
Güz
preset:turn
Dönüş
preset:quadruped:walk
Dört ayaklı yürüyüş
preset:hexapod:walk
Heksapod yürüyüşü
preset:octopod:walk
Ahtapot yürüyüşü
preset:serpentine:march
Yılan gibi hareket
preset:aquatic:march
Suda hareket
Rig v1.0 — Yalnızca iki ayaklı (90’dan fazla ön ayar)
Yalnızca yukarı akış rigging görevinde v1.0-20240301 kullanıldığında kullanılabilir. Duyguları, sporu, dövüşü, dansı ve günlük eylemleri kapsar.
İki ayaklı ön ayar listesinin tamamını genişletmek için tıklayın
