Lewati ke konten
FreshApp Demo

API TERBUKA

Hasilkan dari kode Anda sendiri

Gunakan model situs ini dari server Anda sendiri. Buat generasi dengan kunci API, pantau sampai selesai, lalu unduh file-filenya.

Baca dokumentasi APIKelola kunci API

API hanya memakai kredit berbayar: paket kredit berbayar atau langganan berbayar yang aktif membukanya. Simpan kunci Anda di server Anda.

CONTOH PERMINTAAN

Buat generasi pertama Anda

export API_ORIGIN='https://demo.freshapp.ai'
export API_KEY='sk_YOUR_API_KEY'

curl --fail-with-body "$API_ORIGIN/api/v1/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: order-1001' \
  -d '{"model":"seed-audio-1.0","input":{"prompt":"Mercusuar di atas tebing saat fajar, laut tenang, cahaya lembut."}}'

# Read it every 5 to 10 seconds until its status ends.
curl --fail-with-body "$API_ORIGIN/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

# A delivered output's url is a signed link: no key needed.
curl --fail-with-body -o result "OUTPUT_URL"

Isi API_KEY dengan kunci Anda terlebih dahulu. Kirim Idempotency-Key baru untuk setiap permintaan baru, dan yang sama saat mengirim ulang permintaan itu.

CARA KERJA

Tiga langkah dari permintaan ke file

  1. Buat generasi

    Kirim id model dan inputnya dengan kunci API dan Idempotency-Key. Jawabannya adalah generasi itu, dalam antrean, beserta kredit yang ditahannya.

  2. Pantau

    Baca generasi setiap 5 sampai 10 detik sampai berhasil, berhasil sebagian, gagal, atau dibatalkan. Kredit yang tidak terpakai kembali saat penyelesaian.

  3. Unduh file

    Setiap output yang terkirim menautkan ke filenya di situs ini. Tautan yang didapat kunci sudah ditandatangani dan bisa dibuka selama satu jam tanpa kunci.

IZIN DAN BATAS

Kunci yang hanya melakukan apa yang Anda izinkan

  • Kunci hanya bisa membaca (mendaftar, membaca, dan mengunduh) atau juga bisa menghasilkan (membuat dan membatalkan), dan daftar IP yang diizinkan bisa mengikatnya ke server Anda.

  • Satu permintaan menahan paling banyak 150 kredit, yaitu permintaan termahal dari model yang aktif; pengaturan kunci atau max_credits pada permintaan hanya bisa menurunkannya.

  • Satu kunci menghabiskan paling banyak 5.000 kredit per hari UTC, dan semua kunci satu akun bersama-sama 10.000, kecuali Anda menetapkan batas lain di halaman kunci API.

  • Per kunci dan per akun: 20 pembuatan dan pembatalan serta 240 pembacaan dan unduhan per menit, dan paling banyak 2 generasi berjalan bersamaan.

FILE

File OpenAPI dan klien TypeScript

File OpenAPI 3.1 memuat setiap operasi, input setiap model yang aktif, dan setiap kode galat. Klien TypeScript tidak membutuhkan paket lain: ia memakai Idempotency-Key yang sama di setiap percobaan ulang dan memantau generasi sampai selesai, dan hook React memakainya untuk polling.

Baca dokumentasi APIFile OpenAPI 3.1Klien TypeScriptHook React untuk polling

FAQ

Pertanyaan tentang API