Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

Panduan Pengembangan

Panduan ini membantu Anda mengintegrasikan layanan API kami ke dalam aplikasi Anda.

Pemrosesan Asinkron

API kami menggunakan model pemrosesan asinkron:
  1. Kirim tugas: kirim request pembuatan dan terima ID tugas
  2. Poll status: periksa status tugas secara berkala
  3. Ambil hasil: ambil hasil pembuatan ketika tugas selesai

Contoh polling

import time

def wait_for_completion(client, task_id, max_wait=300):
    """Wait for the task to complete"""
    start_time = time.time()
    
    while time.time() - start_time < max_wait:
        result = client.tasks.get(task_id)
        
        if result.status == "completed":
            return result
        elif result.status == "failed":
            raise Exception(f"Task failed: {result.error}")
        
        time.sleep(2)  # wait 2 seconds before querying again
    
    raise Exception("Task timeout")

Penanganan Error

Error umum

StatusDeskripsiSolusi
400Parameter request tidak validPeriksa parameter dan format request
401Autentikasi gagalVerifikasi API key Anda
402Saldo tidak mencukupiIsi ulang saldo akun Anda
429Rate limit terlampauiKurangi frekuensi request
500Error serverCoba lagi nanti

Contoh

try:
    response = client.images.generate(...)
except EvolinkError as e:
    if e.status_code == 401:
        print("Invalid API key")
    elif e.status_code == 402:
        print("Insufficient account balance")
    else:
        print(f"Error: {e.message}")

Praktik Terbaik

  1. Caching: tautan gambar/video yang dihasilkan berlaku selama 24 jam
  2. Retry: gunakan exponential backoff untuk error sementara
  3. Pemantauan: periksa penggunaan API dan kuota secara berkala
  4. Keamanan: jaga API key Anda tetap aman

Dukungan

Jika Anda mengalami masalah selama pengembangan, Anda dapat memperoleh bantuan melalui:
  • Email: zhihong@apimart.ai
  • Live chat: kunjungi situs web kami
  • Docs: telusuri dokumentasi API lengkap