Kreatif Stüdyo API

Anlat, gör, kullan — yapay zekâyla ürün fotoğrafları, gönderiler, hikâye videoları, seslendirme ve müzik.

Modül kodu creative · 26 işlem · 5 veri modeli · 8 olay. Bir anahtar ya da token, arkasındaki kişinin bu modülde yapabildiğinden fazlasını asla yapamaz; satır düzeyindeki güvenlik uygulamadakiyle birebir aynıdır. Yetki kapsamları: creative (hepsi), creative:read (yalnız okuma) ya da creative:<yetenek>.

Kaynaklar

Listeler limit (en çok 200), cursor, order (ör. -created_at), fields ve q alır; diğer her sorgu parametresi bir sütun süzgecidir: ?status=paid, ?total[gte]=100, ?id[in]=a,b, ?x=null.

İşlemler

creative.cancel

Üretimi iptal et — Başlamamış bir üretimi durdurur.

Gereken izin creative:write · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/creative.cancel

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_generation (update) — queued → cancelled

curl -X POST https://app.getera.io/api/v1/creative_generations/CREATIVE_GENERATION_ID/actions/cancel \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.cancel("CREATIVE_GENERATION_ID")

era creative_generations cancel CREATIVE_GENERATION_ID

{
  "name": "era__creative__cancel",
  "arguments": {
    "id": "CREATIVE_GENERATION_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_queued · 429 çok sık istek

creative.cancel_post

Planlı gönderiyi iptal et — Henüz çıkmamış bir gönderiyi durdurur.

Gereken izin creative:write · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/creative.cancel_post

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_post (update) — scheduled → cancelled

curl -X POST https://app.getera.io/api/v1/creative_posts/CREATIVE_POST_ID/actions/cancel_post \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativePosts.cancelPost("CREATIVE_POST_ID")

era creative_posts cancel_post CREATIVE_POST_ID

{
  "name": "era__creative__cancel_post",
  "arguments": {
    "id": "CREATIVE_POST_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_scheduled · 429 çok sık istek

creative.clone_voice

Ses klonla — Kendi kayıtlarından seslendirme ve dudak senkronu için bir ses yapar. Yalnızca konuşanın izniyle.

Gereken izin creative:write · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır) · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/creative.clone_voice

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.voice_requested

Neye yazar: creative_voice (insert) — A pending voice, made by the studio right after

curl -X POST https://app.getera.io/api/v1/creative_voices/actions/clone_voice \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Voice name","sampleFileIds":{},"consent":true}'

{
  "ok": true,
  "result": "…",
  "events": [
    "creative.voice_requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeVoices.cloneVoice({
  name: "Voice name",
  sampleFileIds: {},
  consent: true
})

era creative_voices clone_voice --data '{"name":"Voice name","sampleFileIds":{},"consent":true}'

{
  "name": "era__creative__clone_voice",
  "arguments": {
    "name": "Voice name",
    "sampleFileIds": {},
    "consent": true
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 empty_name, consent_required, needs_samples · 429 çok sık istek

creative.complete_generation

Üretimi bitir — Sonuçları (dosyalar) ve gerçek maliyeti kaydeder. Yalnızca makine.

Gereken izin creative:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.complete_generation

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.generated

Neye yazar: creative_generation (update) — running → succeeded, with results and cost

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_running, no_outputs · 429 çok sık istek

creative.compose

Resme yazı koy ya da fotoğraf videosu yap — Era kendisi hazırlar — yapay zekâ modeli yok, ücret yok. Bir düzen, gerçek ve doğru yazılmış metni markanın renkleri, yazı tipi ve logosuyla resmin üstüne yerleştirir (kampanya, yeni ürün, fiyat etiketi, duyuru, hikâye çağrısı, menü kartı, pazaryeri bandı, alıntı). Fotoğraf videosu 2–10 fotoğrafı yumuşak hareket, açılış cümlesi, müzik ve kapanış kartıyla dikey bir videoya çevirir.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.compose

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.requested

Neye yazar: creative_generation (insert) — Queues the layout or reel; Era makes it without a model

curl -X POST https://app.getera.io/api/v1/creative_generations/CREATIVE_GENERATION_ID/actions/compose \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"kind":"layout","fileIds":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "creative.requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.compose("CREATIVE_GENERATION_ID", {
  kind: "layout",
  fileIds: {}
})

era creative_generations compose CREATIVE_GENERATION_ID --data '{"kind":"layout","fileIds":{}}'

{
  "name": "era__creative__compose",
  "arguments": {
    "sourceGenerationId": "CREATIVE_GENERATION_ID",
    "kind": "layout",
    "fileIds": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 unknown_layout, needs_image, empty_text, needs_photos, unknown_track, not_found · 429 çok sık istek

creative.edit_again

Videoyu yeniden düzenle — Bitmiş bir yapay zekâ video kurgusunun bir notla (“girişi kısalt, müzik olmasın”) yeni sürümünü yapar; önceki sürümler kalır.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.edit_again

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.requested

Neye yazar: creative_generation (insert) — A queued video edit: the next version, pointing at the one it changes

curl -X POST https://app.getera.io/api/v1/creative_generations/CREATIVE_GENERATION_ID/actions/edit_again \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"note":"What should change"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "creative.requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.editAgain("CREATIVE_GENERATION_ID", {
  note: "What should change"
})

era creative_generations edit_again CREATIVE_GENERATION_ID \
  --note "What should change"

{
  "name": "era__creative__edit_again",
  "arguments": {
    "id": "CREATIVE_GENERATION_ID",
    "note": "What should change"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 empty_note, not_editable · 429 çok sık istek

creative.fail_generation

Üretimi başarısız işaretle — Neden başarısız olduğunu kaydeder. Yalnızca makine.

Gereken izin creative:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.fail_generation

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.failed

Neye yazar: creative_generation (update) — → failed

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_open · 429 çok sık istek

creative.finish_voice

Ses klonlamayı bitir — Sağlayıcının sesini ya da neden başarısız olduğunu kaydeder. Yalnızca makine.

Gereken izin creative:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.finish_voice

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_voice (update) — pending → ready / failed

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_pending · 429 çok sık istek

creative.generate

Görsel, video, seslendirme ya da müzik üret — Anlat (ya da beyaz zeminde ürün, Instagram gönderisi, hikâye videosu, menü fotoğrafı gibi bir hazır seçenek seç); arka planda üretilir, Kreatif Stüdyo’ya ve Dosyalar’a düşer. Maliyet önce gösterilir; kendi aboneliğin ya da anahtarınla çalışır.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.generate

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.requested

Neye yazar: creative_generation (insert) — Queues the generation with its estimate

curl -X POST https://app.getera.io/api/v1/creative_generations/CREATIVE_GENERATION_ID/actions/generate \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"higgsfield":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "creative.requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.generate("CREATIVE_GENERATION_ID", {
  higgsfield: {}
})

era creative_generations generate CREATIVE_GENERATION_ID --data '{"higgsfield":{}}'

{
  "name": "era__creative__generate",
  "arguments": {
    "sourceGenerationId": "CREATIVE_GENERATION_ID",
    "higgsfield": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 empty_prompt, unknown_preset, needs_image, no_source, budget_exceeded, voice_not_ready · 429 çok sık istek

creative.generate_batch

Toplu hazırla — Tek şablonla birçok ürün, fotoğraf ya da satırı birden hazırlar (en fazla 20): "bu 12 ürünü beyaz zeminde", "menüdeki her yemek için bir hikâye". Her biri tek bir topluluk içinde ayrı bir üretimdir.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.generate_batch

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.requested

Neye yazar: creative_generation (insert) — Queues one generation per line, sharing a batch

curl -X POST https://app.getera.io/api/v1/creative_generations/actions/generate_batch \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"items":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "creative.requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.generateBatch({
  items: {}
})

era creative_generations generate_batch --data '{"items":{}}'

{
  "name": "era__creative__generate_batch",
  "arguments": {
    "items": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 empty_batch, batch_too_big, unknown_preset, empty_prompt, needs_image, no_source, budget_exceeded · 429 çok sık istek

creative.generate_set

Ürün fotoğraf stüdyosu: set hazırla — Bir ürün fotoğrafından, ürün aynı kalacak şekilde ayrı ayrı çekimlerden oluşan bir set çıkar: sade (beyaz zemin), açılar (ön · üç çeyrek · yan · arka), yaşam tarzı (sektörüne uygun üç sahne) ya da ilan (beyaz zeminde ana · açı · detay · kullanımda, Trendyol veya Hepsiburada ölçüsünde).

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.generate_set

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.requested

Neye yazar: creative_generation (insert) — Queues one generation per shot, sharing a batch

curl -X POST https://app.getera.io/api/v1/creative_generations/actions/generate_set \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"set":"Set"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "creative.requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.generateSet({
  set: "Set"
})

era creative_generations generate_set \
  --set "Set"

{
  "name": "era__creative__generate_set",
  "arguments": {
    "set": "Set"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 unknown_set, needs_image, no_source, budget_exceeded · 429 çok sık istek

creative.mark_post

Gönderinin durumunu kaydet — planlandı → paylaşılıyor → paylaşıldı / başarısız. Yalnızca makine.

Gereken izin creative:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.mark_post

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.posted, creative.post_failed

Neye yazar: creative_post (update) — Moves the post forward; creative_generation (update) — Adds "used on <channel>"

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_open · 429 çok sık istek

creative.note_provider_job

Sağlayıcı işini kaydet — Bir MuAPI isteğini sonucu sorulmadan önce kaydeder; böylece kurtarma sırasında iki kez gönderilmez. Yalnızca makine.

Gereken izin creative:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.note_provider_job

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_generation (update) — Saves the provider request id

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_running · 429 çok sık istek

creative.park_generation

Sahibinin bilgisayarını bekle — Bir kişinin kendi planıyla çalışan bir üretimi, bilgisayarı yeniden açılana kadar bekletir. Yalnızca sistem kullanır.

Gereken izin creative:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.park_generation

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_generation (update) — running → waiting

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_running, bad_waiting · 429 çok sık istek

creative.record_use

Nerede kullanıldığını kaydet — Bir sonucun bir ürüne, yazıya, e-postaya ya da web sitesine konduğunu hatırlar.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.record_use

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.used

Neye yazar: creative_generation (update) — Appends the use

curl -X POST https://app.getera.io/api/v1/creative_generations/CREATIVE_GENERATION_ID/actions/record_use \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"target":"Used on"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "creative.used"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.recordUse("CREATIVE_GENERATION_ID", {
  target: "Used on"
})

era creative_generations record_use CREATIVE_GENERATION_ID \
  --target "Used on"

{
  "name": "era__creative__record_use",
  "arguments": {
    "id": "CREATIVE_GENERATION_ID",
    "target": "Used on"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, bad_target · 429 çok sık istek

creative.remove

Geçmişten kaldır — Biten bir üretimi geçmişten kaldırır. Dosyaları Dosyalar’da kalır.

Gereken izin creative:delete · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/creative.remove

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_generation (delete) — Deletes the history row

curl -X POST https://app.getera.io/api/v1/creative_generations/CREATIVE_GENERATION_ID/actions/remove \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.remove("CREATIVE_GENERATION_ID")

era creative_generations remove CREATIVE_GENERATION_ID

{
  "name": "era__creative__remove",
  "arguments": {
    "id": "CREATIVE_GENERATION_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found · 429 çok sık istek

creative.remove_ad

Reklam kütüphanesinden kaldır — Bir reklamı kütüphaneden çıkarır.

Gereken izin creative:delete · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/creative.remove_ad

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_ad (delete) — Deletes the ad

curl -X POST https://app.getera.io/api/v1/creative_ads/CREATIVE_AD_ID/actions/remove_ad \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeAds.removeAd("CREATIVE_AD_ID")

era creative_ads remove_ad CREATIVE_AD_ID

{
  "name": "era__creative__remove_ad",
  "arguments": {
    "id": "CREATIVE_AD_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found · 429 çok sık istek

creative.remove_voice

Sesi kaldır — Klonlanmış bir sesi siler (sağlayıcıda da).

Gereken izin creative:delete · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/creative.remove_voice

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_voice (delete) — Deletes the voice

curl -X POST https://app.getera.io/api/v1/creative_voices/CREATIVE_VOICE_ID/actions/remove_voice \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeVoices.removeVoice("CREATIVE_VOICE_ID")

era creative_voices remove_voice CREATIVE_VOICE_ID

{
  "name": "era__creative__remove_voice",
  "arguments": {
    "id": "CREATIVE_VOICE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found · 429 çok sık istek

creative.resume_provider

Sağlayıcı sonucunu yeniden kontrol et — Kaydedilmiş MuAPI işini, yeni bir üretim satın almadan yeniden sorar.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.resume_provider

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.requested

Neye yazar: creative_generation (update) — Requeues polling of the saved provider job

curl -X POST https://app.getera.io/api/v1/creative_generations/CREATIVE_GENERATION_ID/actions/resume_provider \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "creative.requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.resumeProvider("CREATIVE_GENERATION_ID")

era creative_generations resume_provider CREATIVE_GENERATION_ID

{
  "name": "era__creative__resume_provider",
  "arguments": {
    "id": "CREATIVE_GENERATION_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found · 429 çok sık istek

creative.save_ad

Reklamı kütüphaneye kaydet — Beğendiğin bir reklamı (Meta Reklam Kütüphanesi’nden, bir bağlantıdan ya da ekran görüntüsünden) saklar; Kreatif Stüdyo ürünün için benzerini yapabilir.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.save_ad

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_ad (upsert) — Adds (or refreshes) the ad in the library

curl -X POST https://app.getera.io/api/v1/creative_ads/actions/save_ad \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"source":"From","title":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeAds.saveAd({
  source: "From",
  title: "Name"
})

era creative_ads save_ad \
  --source "From" \
  --title "Name"

{
  "name": "era__creative__save_ad",
  "arguments": {
    "source": "From",
    "title": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 bad_source, empty_title · 429 çok sık istek

creative.save_brand_kit

Marka kitini kaydet — Ad, renkler, yazı tipleri, logo ve ses tonu — Kreatif Stüdyo, tek bir üretim için kapatmazsan bunları her üretime ekler.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.save_brand_kit

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_brand_kit (upsert) — Writes the one brand kit of the workspace

curl -X POST https://app.getera.io/api/v1/creative_brand_kits/actions/save_brand_kit \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Brand name"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeBrandKits.saveBrandKit({
  name: "Brand name"
})

era creative_brand_kits save_brand_kit \
  --name "Brand name"

{
  "name": "era__creative__save_brand_kit",
  "arguments": {
    "name": "Brand name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 empty_name, bad_colour, unknown_sector · 429 çok sık istek

creative.save_caption

Gönderi metnini kaydet — Bir sonuçla birlikte paylaşılacak açıklamayı ve etiketleri saklar.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.save_caption

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_generation (update) — Sets the caption

curl -X POST https://app.getera.io/api/v1/creative_generations/CREATIVE_GENERATION_ID/actions/save_caption \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"text":"Text"}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.saveCaption("CREATIVE_GENERATION_ID", {
  text: "Text"
})

era creative_generations save_caption CREATIVE_GENERATION_ID \
  --text "Text"

{
  "name": "era__creative__save_caption",
  "arguments": {
    "id": "CREATIVE_GENERATION_ID",
    "text": "Text"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 empty_caption, not_found · 429 çok sık istek

creative.schedule_post

Sosyal medyada paylaş — Bir Kreatif Stüdyo sonucunu (ya da dosyaları) bir Instagram, Facebook, TikTok ya da YouTube hesabında şimdi ya da belirli bir saatte paylaşır. Paylaşmadan önce her zaman sorar.

Gereken izin creative:write · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır) · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/creative.schedule_post

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.post_scheduled

Neye yazar: creative_post (insert) — A scheduled post; the studio posts it when it is due

curl -X POST https://app.getera.io/api/v1/creative_posts/actions/schedule_post \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"channel":"Where","connectionId":"CONNECTION_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "creative.post_scheduled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativePosts.schedulePost({
  channel: "Where",
  connectionId: "CONNECTION_ID"
})

era creative_posts schedule_post \
  --channel "Where" \
  --connection-id "CONNECTION_ID"

{
  "name": "era__creative__schedule_post",
  "arguments": {
    "channel": "Where",
    "connectionId": "CONNECTION_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 bad_channel, not_ready, nothing_to_post, wrong_media, no_connection, bad_time · 429 çok sık istek

creative.set_favourite

Favori — Kolayca bulunması için bir üretimi yıldızlar.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.set_favourite

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_generation (update) — Sets the star

curl -X POST https://app.getera.io/api/v1/creative_generations/CREATIVE_GENERATION_ID/actions/set_favourite \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"favourite":true}'

{
  "ok": true,
  "result": "…",
  "events": []
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.setFavourite("CREATIVE_GENERATION_ID", {
  favourite: true
})

era creative_generations set_favourite CREATIVE_GENERATION_ID \
  --favourite true

{
  "name": "era__creative__set_favourite",
  "arguments": {
    "id": "CREATIVE_GENERATION_ID",
    "favourite": true
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found · 429 çok sık istek

creative.start_generation

Üretimi başlat — Sıradaki bir üretimi onu yapacak çalışana ayırır. Yalnızca makine.

Gereken izin creative:handle · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.start_generation

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Neye yazar: creative_generation (update) — queued → running

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:handle izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_queued · 429 çok sık istek

creative.vary

Buna benzer — Biten bir görselin yeni çekimleri: aynı konu ve ürün; yeni kompozisyon, açı ve ışık. Bir seferde 1–4 tane.

Gereken izin creative:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/creative.vary

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: creative.requested

Neye yazar: creative_generation (insert) — Queues the variations

curl -X POST https://app.getera.io/api/v1/creative_generations/CREATIVE_GENERATION_ID/actions/vary \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"count":1}'

{
  "ok": true,
  "result": "…",
  "events": [
    "creative.requested"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.creativeGenerations.vary("CREATIVE_GENERATION_ID", {
  count: 1
})

era creative_generations vary CREATIVE_GENERATION_ID \
  --count 1

{
  "name": "era__creative__vary",
  "arguments": {
    "id": "CREATIVE_GENERATION_ID",
    "count": 1
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde creative:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, no_source, budget_exceeded · 429 çok sık istek

Veri modelleri

CreativeAd

Tablo creative_ad · Kaynak creative_ads

• GET /api/v1/creative_ads
• GET /api/v1/creative_ads/{id}

Birincil anahtar: id

CreativeBrandKit

Tablo creative_brand_kit · Kaynak creative_brand_kits

• GET /api/v1/creative_brand_kits
• GET /api/v1/creative_brand_kits/{id}

Birincil anahtar: id

Denetimler:

• CHECK (((array_length(colours, 1) IS NULL) OR (array_length(colours, 1) <= 8)))

CreativeGeneration

Tablo creative_generation · Kaynak creative_generations

• GET /api/v1/creative_generations
• GET /api/v1/creative_generations/{id}

Birincil anahtar: id

Denetimler:

• CHECK (((batch_kind IS NULL) OR (batch_kind = ANY (ARRAY['set'::text, 'batch'::text, 'variations'::text]))))
• CHECK (((batch_label IS NULL) OR (length(batch_label) <= 120)))
• CHECK (((count >= 1) AND (count <= 4)))
• CHECK (((edit_note IS NULL) OR (length(edit_note) <= 2000)))
• CHECK (((resolution IS NULL) OR (resolution = ANY (ARRAY['480p'::text, '720p'::text, '1080p'::text]))))
• CHECK (((source_kind IS NULL) OR (source_kind = ANY (ARRAY['native'::text, 'byos'::text, 'byok'::text])))) NOT VALID
• CHECK (((studio IS NULL) OR (studio = ANY (ARRAY['image'::text, 'video'::text, 'cinema'::text, 'character'::text, 'lipsync'::text, 'motion'::text, 'recast'::text, 'clip'::text, 'layers'::text, 'audio'::text, 'marketing'::text, 'product'::text]))))
• CHECK (((tool IS NULL) OR (tool = ANY (ARRAY['lip_sync'::text, 'talking_photo'::text, 'face_swap'::text, 'upscale'::text, 'video_edit'::text, 'layout'::text, 'photo_reel'::text, 'higgsfield'::text, 'image_grade'::text]))))
• CHECK (((upscale IS NULL) OR (upscale = ANY (ARRAY[2, 4]))))
• CHECK (((version >= 1) AND (version <= 999)))

CreativePost

Tablo creative_post · Kaynak creative_posts

• GET /api/v1/creative_posts
• GET /api/v1/creative_posts/{id}

Birincil anahtar: id

CreativeVoice

Tablo creative_voice · Kaynak creative_voices

• GET /api/v1/creative_voices
• GET /api/v1/creative_voices/{id}

Birincil anahtar: id

Denetimler:

• CHECK ((provider = 'elevenlabs'::text))
• CHECK (((source_kind IS NULL) OR (source_kind = 'byok'::text)))

Olaylar

İş akışları ve webhook'lar bu olaylara tepki verir.