Μετάβαση στο περιεχόμενο
fcaaiΣύνδεσηΞεκίνα δωρεάν
v1.1 · Σε λειτουργίαREST · JSONUSD

Τεκμηρίωση API

Ασύγχρονες εργασίες, υπογεγραμμένα webhooks, endpoints συμβατά με OpenAI. Πληρώνεις ανά εκτέλεση και οι αποτυχημένες εργασίες επιστρέφονται.

Βασικό URLhttps://api.fcaai.ai/v1

Γρήγορη εκκίνηση

  1. Δημιουργία κλειδιούΛογαριασμός › Κλειδιά προγραμματιστή. Χρησιμοποίησε δοκιμαστικό κλειδί για να κρατάς την ανάπτυξη χωριστά από την παραγωγή· οι εκτελέσεις χρεώνονται το ίδιο: fcaai_test_ Βάλ’ το στο FCAAI_API_KEY· τα SDK και το CLI το διαβάζουν από εκεί.
  2. Εγκατάστησε ένα SDK ή το CLITypeScript για Node 18+, Deno, Bun και edge runtimes, Python 3.9+ ή το τερματικό. Το curl δεν χρειάζεται εγκατάσταση. npm i @fcaai/sdkpip install fcaainpm i -g @fcaai/cli
  3. Εκτέλεσε την πρώτη σου δημιουργίαΗ κλήση επιστρέφει αμέσως 202 με το id της εργασίας και την τιμή της. Με { wait: true } το SDK επιστρέφει μόλις ολοκληρωθεί η εργασία.
export FCAAI_API_KEY="fcaai_test_…"

# 1) queue a job → 202 { "id", "status": "queued", "price_usd", "eta_seconds" }
curl https://api.fcaai.ai/v1/generations \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model":"fca/magic-pro","input":{"prompt":"glass villa on a pine ridge at blue hour","aspect_ratio":"16:9","resolution":"2k"}}'

# 2) long poll: holds up to 60 s, returns as soon as the job ends; repeat while queued/running
curl "https://api.fcaai.ai/v1/generations/$GEN_ID?wait=50" \
  -H "Authorization: Bearer $FCAAI_API_KEY"
# → "status": "succeeded", "output": [{ "url": "https://…", "kind": "image", … }]

Έλεγχος ταυτότητας

Στείλε το κλειδί σου ως bearer token με κάθε αίτημα.

  • Τα κλειδιά που ξεκινούν με fcaai_live_ είναι για παραγωγή και αυτά που ξεκινούν με fcaai_test_ για ανάπτυξη. Και τα δύο χρεώνονται με τον ίδιο τρόπο· τα δοκιμαστικά κλειδιά απλώς κρατούν τα περιβάλλοντα χωριστά.
  • Ένα κλειδί εμφανίζεται μία φορά, όταν το δημιουργείς, και κρατάμε μόνο ένα αποτύπωμά του. Αποθήκευσέ το σε μεταβλητή περιβάλλοντος όπως FCAAI_API_KEY, ποτέ σε κώδικα που εκτελείται σε πρόγραμμα περιήγησης ή εφαρμογή.
  • Ένα κλειδί που λείπει, είναι λάθος, ανακλήθηκε ή έληξε επιστρέφει 401. Ένα κλειδί χωρίς το σωστό δικαίωμα ή που χρησιμοποιείται από IP εκτός της λίστας επιτρεπόμενων επιστρέφει 403.
curl https://api.fcaai.ai/v1/models \
  -H "Authorization: Bearer $FCAAI_API_KEY"

Πώς επιστρέφουν τα αποτελέσματα

Κάθε δημιουργία είναι μια εργασία: queued → running → succeeded, failed ή canceled. Οι αποτυχημένες και οι ακυρωμένες εργασίες επιστρέφονται.

{
  "id": "cmvusmtm300234pbo7l6ecl3f",
  "object": "generation",
  "model": "fca/magic-pro",
  "status": "queued",
  "price_usd": 0.03,
  "currency": "USD",
  "eta_seconds": 14,
  "output": null
}

Ακύρωση δημιουργίας

Μια δημιουργία στην ουρά μπορεί να ακυρωθεί και το δεσμευμένο ποσό της αποδεσμεύεται. Μόλις ξεκινήσει, συνήθως δεν μπορεί: παίρνεις 409 already_started και ολοκληρώνεται και χρεώνεται κανονικά.

  • Διάβασε πρώτα το cancellable της δημιουργίας: είναι πάντα true όσο είναι στην ουρά και συνήθως false μόλις ξεκινήσει.
  • Η ακύρωση μιας δημιουργίας που έχει ήδη ολοκληρωθεί την επιστρέφει αμετάβλητη.
# can it still be cancelled?
curl https://api.fcaai.ai/v1/generations/$GEN_ID -H "Authorization: Bearer $FCAAI_API_KEY"
# → "status": "queued", "cancellable": true, …

curl -X POST https://api.fcaai.ai/v1/generations/$GEN_ID/cancel -H "Authorization: Bearer $FCAAI_API_KEY"
# → 200: the generation, "status": "canceled"
# → 409 "already_started": it finishes and is charged as usual

Χρήση και υπόλοιπο

Το GET /v1/account/usage επιστρέφει δημιουργίες, αποτυχίες και δαπάνες σε USD ανά ημέρα και μοντέλο. Καλύπτει τις τελευταίες 30 ημέρες, εκτός αν δώσεις from και to ως YYYY-MM-DD.

  • Το GET /v1/account/balance επιστρέφει το διαθέσιμο υπόλοιπό σου σε USD.
# per day and model; the last 30 days unless you pass from and to
curl "https://api.fcaai.ai/v1/account/usage?from=2026-10-01&to=2026-10-31" -H "Authorization: Bearer $FCAAI_API_KEY"

curl https://api.fcaai.ai/v1/account/balance -H "Authorization: Bearer $FCAAI_API_KEY"
Βήμα προς βήμα

Οδηγοί

Συνταγές βήμα προς βήμα για τις πιο συνηθισμένες εργασίες. Τα παραδείγματα χρησιμοποιούν τα επίσημα SDK· η καρτέλα curl δείχνει το απλό αίτημα HTTP.

Επεξεργασία εικόνας με εικόνες αναφοράς

Στείλε τη φωτογραφία προς επεξεργασία και τις εικόνες αναφοράς σε μία λίστα images και περίγραψε την αλλαγή. Αναφέρσου στις εικόνες με τη σειρά τους (image 1, image 2…).

  1. Ανέβασε τοπικά αρχεία ή χρησιμοποίησε οποιοδήποτε δημόσιο URL https.
  2. Βάλε την εικόνα προς επεξεργασία πρώτη στο images· οι υπόλοιπες είναι αναφορές.
  3. Έλεγξε το constraints.max_input_images στις λεπτομέρειες του μοντέλου: δείχνει πόσες εικόνες δέχεται το μοντέλο.

Αποθηκευμένοι χαρακτήρες, προϊόντα και τοποθεσίες από τη βιβλιοθήκη σου προστίθενται με το element_ids (έως 3)· οι εικόνες αναφοράς τους επισυνάπτονται από τη δική μας πλευρά.

curl https://api.fcaai.ai/v1/generations \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"google/nano-banana-pro","input":{"prompt":"Put the armchair from image 2 next to the window. Keep the room, light and camera unchanged.","images":["https://example.com/room.jpg","https://example.com/armchair.jpg"],"resolution":"2k"}}'

# how many images this model takes
curl https://api.fcaai.ai/v1/models/google/nano-banana-pro -H "Authorization: Bearer $FCAAI_API_KEY"
# → "constraints": { "max_input_images": …, … }

Από εικόνα σε βίντεο με αρχικό και τελικό καρέ

Τα μοντέλα βίντεο δέχονται το πρώτο καρέ στο image και, όταν το υποστηρίζουν, το τελευταίο καρέ στο end_image. Το κλιπ κινείται από το ένα στο άλλο.

  1. Έλεγξε το μοντέλο: το constraints.features.end_frame πρέπει να είναι true και η διάρκεια να ταιριάζει με το constraints.duration.
  2. Στείλε image, end_image, το prompt και τη διάρκεια. Οι κινήσεις κάμερας γράφονται ως απλό κείμενο στο prompt.
  3. Το βίντεο χρειάζεται λίγα λεπτά: περίμενε με μεγαλύτερο timeout ή χρησιμοποίησε webhook.

Τα μοντέλα με features.reference έχουν επίσης λειτουργία αναφοράς: στείλε reference_images αντί για καρέ και ονόμασέ τα @Image1, @Image2 στο prompt. Δεν συνδυάζεται με image ή end_image.

# price with an end frame
curl "https://api.fcaai.ai/v1/models/kling/3.0-pro?duration=5&end_image=1" -H "Authorization: Bearer $FCAAI_API_KEY"

curl https://api.fcaai.ai/v1/generations \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling/3.0-pro","input":{"prompt":"slow dolly in, morning light moves across the floor","image":"https://example.com/start.jpg","end_image":"https://example.com/end.jpg","duration":5}}'

Αναβάθμιση εικόνας

Οι αναβαθμιστές δέχονται ένα image και κλίμακα στο tier. Το fca/upscale έχει δύο στυλ: Standard για φωτογραφίες (έως 16x) και Sharp για renders, κατόψεις και κείμενο (έως 4x).

  1. Πάρε την τιμή για το μέγεθος της πηγής σου: ?tier=4x&source_width=…&source_height=….
  2. Στείλε την εικόνα και την κλίμακα. Το "tier": "max" επιλέγει τη μεγαλύτερη κλίμακα που χωρά η εικόνα (έξοδος έως 64 MP).
  3. Το νέο μέγεθος βρίσκεται στο width / height της εξόδου.

Οι βελτιωτές, ο επαναφωτισμός, η επέκταση, η αφαίρεση φόντου και η αναβάθμιση βίντεο εμφανίζονται με το GET /v1/models?type=upscale.

curl "https://api.fcaai.ai/v1/models/fca/upscale?tier=4x&source_width=1600&source_height=1000" -H "Authorization: Bearer $FCAAI_API_KEY"

curl https://api.fcaai.ai/v1/generations \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"fca/upscale","input":{"image":"https://example.com/render.jpg","tier":"4x","extra":{"look":"sharp"}}}'

Εκτέλεση προτύπου

Τα πρότυπα είναι έτοιμες συνταγές με λίγες ονομασμένες εισόδους. Το prompt μένει στη δική μας πλευρά: στέλνεις τιμές και παίρνεις πίσω μια κανονική δημιουργία.

  1. Πάρε το πρότυπο για να δεις τα inputs του (key, type, required, options) και το pricing του.
  2. Εκτέλεσέ το με { "values": { key: value } }. Οι είσοδοι εικόνας δέχονται URL https.
  3. Περίμενέ το όπως κάθε άλλη εργασία. Μια λάθος τιμή επιστρέφει 400 invalid_values με fields.

Τα πρότυπα πολλών βημάτων (package) ξεκινούν μια εκτέλεση προτύπου με πολλά βήματα: χρησιμοποίησε templates.runPackage / run_package.

curl https://api.fcaai.ai/v1/templates -H "Authorization: Bearer $FCAAI_API_KEY"
curl https://api.fcaai.ai/v1/templates/$SLUG -H "Authorization: Bearer $FCAAI_API_KEY"     # inputs, pricing, options (models[].id → run "model")

curl https://api.fcaai.ai/v1/templates/$SLUG/run \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"values":{"photo":"https://example.com/room.jpg"}}'
# → 202: a generation (poll GET /v1/generations/{id}?wait=50)
#   multi-step templates return a template_run (GET /v1/templates/runs/{id})

Πάρε πρώτα την τιμή και τις επιλογές του μοντέλου

Μία δωρεάν κλήση επιστρέφει όλα όσα δέχεται ένα μοντέλο και την ακριβή τιμή για τις ρυθμίσεις σου. Χρησιμοποιεί την ίδια λογική τιμολόγησης με το POST /v1/generations, οπότε η προσφορά είναι αυτό που πληρώνεις.

  1. Κάλεσε το GET /v1/models/{id} με τις ρυθμίσεις που θα στείλεις: duration · resolution · quality · tier · count · audio=1 · images=2 · end_image=1 · reference_images=3.
  2. Διάβασε την τιμή στο estimate.price_usd και έλεγξε το availability πριν την εκτέλεση.
  3. Φτιάξε τη φόρμα σου από τα options και constraints: αναλογίες, αναλύσεις, διάρκεια, μέγιστες έξοδοι, μέγιστες εικόνες εισόδου και δυνατότητες.

Μια τιμή που δεν επιτρέπει το μοντέλο επιστρέφει στο invalid_params, με το πεδίο και τις επιτρεπτές τιμές.

curl "https://api.fcaai.ai/v1/models/google/veo-3.1?duration=8&resolution=1080p&audio=1&end_image=1" -H "Authorization: Bearer $FCAAI_API_KEY"
# → { "availability": "available",
#     "estimate": { "price_usd": …, "price_display": "$…", "currency": "USD" },
#     "options": { … }, "constraints": { … }, "input_schema": { … } }

curl "https://api.fcaai.ai/v1/models?type=video" -H "Authorization: Bearer $FCAAI_API_KEY"   # the whole catalog for your key

Μεταφόρτωση αρχείων

Κάθε είσοδος είναι ένα URL https. Τα δημόσια URL λειτουργούν όπως είναι· ανέβασε πρώτα τα τοπικά αρχεία και χρησιμοποίησε το url που παίρνεις πίσω.

  1. Έως 50 MB: ένα αίτημα στο POST /v1/uploads.
  2. Έως 2 GB: άνοιξε μια συνεδρία, στείλε τμήματα των 8 MB με οποιαδήποτε σειρά (και παράλληλα) και μετά ολοκλήρωσέ τη.
  3. Στείλε το sha256 όταν ανοίγεις τη συνεδρία για να συνεχίσεις μια διακοπείσα μεταφόρτωση ή να παραλείψεις ένα αρχείο που είναι ήδη αποθηκευμένο.

Τα SDK και το CLI χωρίζουν το αρχείο, στέλνουν 3 τμήματα τη φορά και συνεχίζουν με το id της συνεδρίας.

# ≤ 50 MB
curl https://api.fcaai.ai/v1/uploads -H "Authorization: Bearer $FCAAI_API_KEY" -F "[email protected]"
# → 201 { "id": "…", "object": "upload", "url": "https://…", "mime": "image/jpeg", "bytes": … }

# up to 2 GB: 1) start a session
curl https://api.fcaai.ai/v1/uploads/sessions \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"walkthrough.mp4","mime":"video/mp4","bytes":104857600}'
# 2) PUT each 8 MB chunk (any order, in parallel)
split -b 8388608 -d -a 4 walkthrough.mp4 part_
curl -X PUT https://api.fcaai.ai/v1/uploads/sessions/$SESSION/chunks/0 -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/octet-stream" --data-binary @part_0000
# 3) finish → { "upload": { "url": … } }
curl -X POST https://api.fcaai.ai/v1/uploads/sessions/$SESSION/complete -H "Authorization: Bearer $FCAAI_API_KEY"

Αποτελέσματα μέσω webhook

Αντί για polling, άφησέ μας να καλούμε τον server σου όταν τελειώνει μια εργασία. Καταχώρισε ένα URL για όλο τον λογαριασμό ή πρόσθεσε options.webhook_url σε ένα μεμονωμένο αίτημα (το secret του επιστρέφεται μία φορά ως webhook_secret).

  1. Καταχώρισε με POST /v1/webhooks: το URL https σου και τα συμβάντα που θέλεις. Το secret εμφανίζεται μόνο μία φορά, οπότε αποθήκευσέ το.
  2. Επαλήθευσε κάθε παράδοση: το X-FCAAI-Signature: t=…,v1=… είναι ένα HMAC-SHA256 του t + "." + rawBody με το secret σου. Χρησιμοποίησε το ακατέργαστο body και απόρριψε παλιά timestamps.
  3. Απάντησε γρήγορα με 2xx και κάνε τη δουλειά μετά. Μια αποτυχημένη παράδοση επιχειρείται 5 φορές συνολικά: αμέσως, μετά από 30 s, 2 λεπτά, 10 λεπτά και 1 ώρα. Κάθε προσπάθεια καταγράφεται στο GET /v1/webhooks/{id}/deliveries.

Ένα συμβάν μπορεί να φτάσει πάνω από μία φορά· χρησιμοποίησε το id του για να παραλείπεις τα διπλότυπα.

Συμβάντα
generation.succeededgeneration.failedgeneration.canceledflow_run.succeededflow_run.failedflow_run.canceledtimeline.preview_readytimeline.donetimeline.failedapproval.requestedapproval.decided

Γίνονται δεκτές μόνο δημόσιες διευθύνσεις https, και η διεύθυνση ελέγχεται ξανά σε κάθε παράδοση.

curl https://api.fcaai.ai/v1/webhooks \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/fcaai-hook","events":["generation.succeeded","generation.failed"]}'
# → 201 { "id": "…", "events": [ … ], "secret": "whsec_…" }   (secret shown only here)

# or one event for one job: add to POST /v1/generations
#   "options": { "webhook_url": "https://example.com/fcaai-hook" }
# → the 202 response carries "webhook_secret" (shown only there)

# delivery log: the latest 50 attempts
curl https://api.fcaai.ai/v1/webhooks/$WEBHOOK_ID/deliveries -H "Authorization: Bearer $FCAAI_API_KEY"

Χειρισμός σφαλμάτων και αγνοημένων ρυθμίσεων

Τα σφάλματα επιστρέφουν ως JSON με σταθερό error.code για διακλάδωση. Μια ρύθμιση που δεν μπορεί να εφαρμοστεί δεν αποτυγχάνει την εργασία: καταγράφεται στο ignored_fields.

  1. Έλεγξε την κατάσταση HTTP και το error.code. Όταν μια τιμή είναι λάθος, το allowed δείχνει τις έγκυρες.
  2. Επανάλαβε τα 429 και 5xx μετά από Retry-After, με το ίδιο Idempotency-Key ώστε τίποτα να μη χρεωθεί δύο φορές. Τα SDK κάνουν και τα δύο για σένα.
  3. Διάβασε το ignored_fields στην απόκριση 202· κάθε καταχώριση έχει field · reason · message.

Οι αποτυχημένες εργασίες επιστρέφονται αυτόματα. Αν η συνηθισμένη διαδρομή ενός μοντέλου είναι εκτός λειτουργίας, η εργασία μεταφέρεται μόνη της σε εναλλακτική διαδρομή· το 503 model_unavailable σημαίνει ότι δεν υπάρχει διαθέσιμη διαδρομή αυτή τη στιγμή.

ΚατάστασηΚωδικοίΤι να κάνεις
400invalid_bodyinvalid_durationinvalid_aspect_ratiomodel_not_allowedΈνα πεδίο λείπει ή δεν επιτρέπεται για αυτό το μοντέλο. Διόρθωσε το αίτημα· αν το στείλεις ξανά αμετάβλητο, θα αποτύχει ξανά.
401invalid_api_keyapi_key_revokedapi_key_expiredΤο κλειδί λείπει, είναι λάθος, ανακλήθηκε ή έληξε.
402insufficient_balancekey_spend_cap_reachedΑνεπαρκές υπόλοιπο ή το κλειδί συμπλήρωσε το μηνιαίο όριό του. Δεν χρεώθηκε τίποτα.
403insufficient_scopeip_not_allowedΤο κλειδί δεν έχει κάποιο δικαίωμα (δες required_scope) ή η IP του αιτήματος δεν είναι στη λίστα επιτρεπόμενων.
404model_not_foundΔεν υπάρχει τέτοιο μοντέλο ή δεν είναι διαθέσιμο για το κλειδί σου.
429rate_limitedΠάρα πολλά αιτήματα. Περίμενε τον χρόνο που δείχνει το Retry-After.
503model_unavailableΤο μοντέλο είναι απασχολημένο ή εκτός λειτουργίας. Δοκίμασε ξανά σε λίγο ή διάλεξε άλλο μοντέλο.
Αιτίες στο ignored_fields
unknown_field
Δεν είναι πεδίο αυτού του αιτήματος· έλεγξε την ορθογραφία.
not_supported_by_model
Έγκυρο πεδίο που αυτό το μοντέλο δεν δέχεται.
nearest_supported
Η αναλογία δεν προσφέρεται· χρησιμοποιείται η πλησιέστερη.
follows_input_image
Κατά την επεξεργασία, αυτό το μοντέλο κρατά το μέγεθος ή την αναλογία της εικόνας εισόδου.
unpriced_extra
Αφαιρέθηκε μια επιπλέον ρύθμιση που δεν ορίζει το μοντέλο.
import { Fcaai, FcaaiError } from '@fcaai/sdk'

type Ignored = { field: string; reason: string; message: string }
const fcaai = new Fcaai({ maxRetries: 2 }) // 429 / 5xx / network errors: retried with backoff, honoring Retry-After

try {
  const gen = await fcaai.generations.create({ model: 'google/veo-3.1', input: { prompt: 'waves at dusk, slow pan', duration: 6 } })
  const { ignored_fields = [] } = gen as unknown as { ignored_fields?: Ignored[] }
  for (const f of ignored_fields) console.warn(f.field + ' ignored (' + f.reason + '): ' + f.message)
} catch (e) {
  if (!(e instanceof FcaaiError)) throw e
  const allowed = (e.body as { error?: { allowed?: unknown[] } } | null)?.error?.allowed
  if (e.status === 400) console.error(e.code, e.message, allowed)   // fix the request; do not retry as is
  else if (e.status === 402) console.error('Top up, or raise the key cap:', e.message)
  else if (e.code === 'model_unavailable') console.error('Retry shortly or pick another model')
  else throw e
}

Endpoints συμβατά με OpenAI

Κώδικας που ήδη χρησιμοποιεί client του OpenAI λειτουργεί αν αλλάξεις δύο πράγματα: το βασικό URL και το κλειδί. Υποστηρίζονται συνομιλία και δημιουργία εικόνων.

  1. Όρισε το βασικό URL σε https://api.fcaai.ai/v1 και χρησιμοποίησε το κλειδί σου στο fcaai ως κλειδί API.
  2. Συνομιλία: POST /v1/chat/completions με το μοντέλο fca/chat. Streaming, εργαλεία και έξοδος JSON λειτουργούν κανονικά.
  3. Εικόνες: το POST /v1/images/generations περιμένει έως 90 s και επιστρέφει data[].url. Αν η εργασία χρειάζεται περισσότερο, παίρνεις 202 με fcaai.generation_id· παρακολούθησέ τη με GET /v1/generations/{id}.

Για βίντεο, ήχο, 3D, αναβάθμιση και κάθε επιλογή μοντέλου, χρησιμοποίησε το POST /v1/generations.

curl https://api.fcaai.ai/v1/chat/completions \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"fca/chat","messages":[{"role":"user","content":"Write a one-line caption for a walnut side table."}]}'

curl https://api.fcaai.ai/v1/images/generations \
  -H "Authorization: Bearer $FCAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"google/nano-banana-pro","prompt":"a paper plane on a wooden desk","size":"1536x1024"}'
# → { "created": …, "data": [{ "url": "https://…" }], "fcaai": { "generation_id": "…", "price_usd": … } }

Μεταπώληση στους δικούς σου πελάτες

Οι λογαριασμοί μεταπωλητή μπορούν να ανοίξουν υπολογαριασμό για κάθε πελάτη, να του δώσουν δικά του κλειδιά και να παρακολουθούν τη χρήση ανά πελάτη σε τιμή χονδρικής.

  1. Χρησιμοποίησε κλειδί διαχείρισης με το δικαίωμα reseller:manage. Τα κλειδιά πελατών δεν το παίρνουν ποτέ.
  2. Δημιούργησε τον πελάτη με POST /v1/reseller/subtenants και μετά το κλειδί του με POST /v1/reseller/subtenants/{id}/keys. Το πλήρες κλειδί εμφανίζεται μόνο μία φορά.
  3. Παρακολούθησε χρήση και περιθώριο ανά πελάτη με GET /v1/reseller/usage. Για να σημειώνεις τους δικούς σου τελικούς χρήστες στις δημιουργίες, στείλε external_user_id.

Τα κλειδιά χωρίς δικαίωμα μεταπωλητή λαμβάνουν 403 σε αυτά τα endpoints.

curl https://api.fcaai.ai/v1/reseller/subtenants \
  -H "Authorization: Bearer $FCAAI_RESELLER_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Acme Studio","plan":"pro","retail_markup":1.5}'

curl https://api.fcaai.ai/v1/reseller/subtenants/$CUSTOMER_ID/keys \
  -H "Authorization: Bearer $FCAAI_RESELLER_KEY" -H "Content-Type: application/json" \
  -d '{"name":"production","mode":"live"}'

curl "https://api.fcaai.ai/v1/reseller/usage?from=2026-10-01" -H "Authorization: Bearer $FCAAI_RESELLER_KEY"
Αναφορά

Τι μπορείς να φτιάξεις

69 endpoints. Το καθένα υπάρχει στην πλήρη αναφορά με παραδείγματα σε curl, TypeScript και Python.

GET/v1/style-kitsΚιτ στυλ
GET/v1/elementsΣτοιχεία
POST/v1/video-editsΕπεξεργασία βίντεο: περικοπή, ένωση, εικόνες, κείμενο & λογότυπο, ηχητική επένδυση (ασύγχρονα, δωρεάν)
GET/v1/generationsΛίστα δημιουργιών
POST/v1/generationsΔημιουργία νέας δημιουργίας (ασύγχρονα)
GET/v1/generations/{id}Λήψη δημιουργίας (long-poll με wait)
POST/v1/generations/{id}/cancelΑκύρωση (αποδέσμευση δεσμευμένου υπολοίπου)

Τιμές

Δολάρια ανά εκτέλεση, από το ίδιο υπόλοιπο με το πλάνο σου. Αυτές είναι οι τρέχουσες τιμές με τις προεπιλεγμένες ρυθμίσεις· κάθε σελίδα μοντέλου δείχνει όλες τις τιμές ανά ανάλυση και διάρκεια.

ΜοντέλοΕργασίαAPI (USD)
Nano Banana ProΕικόνα · εικόνα · 2K$0.13
GPT Image 2.5 FlareΕικόνα · εικόνα · 2K$0.055
FCA Magic ProΕικόνα · εικόνα · 2K$0.03
Kling 3.0 ProΒίντεο · ανά δευτερόλεπτο · 1080p$0.11
FCA Magic V3Βίντεο · ανά δευτερόλεπτο · 1080p$0.017
ElevenLabs v3Ήχος · κλιπ$0.024
Οι προσφορές τιμής είναι δωρεάνΕπιστροφή χρημάτων για αποτυχημένες εκτελέσειςΗ αυτόματη φόρτωση είναι ανενεργή από προεπιλογήΔεν υπάρχει απεριόριστο πλάνο στο API

Κλειδιά και όρια

Κάθε κλειδί έχει τα δικά του δικαιώματα, ρυθμό και όριο δαπανών. Τα headers της απόκρισης δείχνουν τι απομένει.

120 / λεπτόΠροεπιλεγμένος ρυθμός αιτημάτων ανά κλειδί. X-RateLimit-*
2Εργασίες που εκτελούνται ταυτόχρονα ανά κλειδί (μπορεί να αυξηθεί).
Μηνιαίο όριοΣε USD· όταν συμπληρωθεί, τα αιτήματα λαμβάνουν 402 key_spend_cap_reached
ΔικαιώματαΕικόνα, βίντεο, ήχος, 3D, αναβάθμιση και LLM ενεργοποιούνται ένα-ένα.
Λίστα επιτρεπόμενων IPΚλείδωσε ένα κλειδί στις διευθύνσεις IP των servers σου.
Idempotency-KeyΗ επανάληψη με το ίδιο κλειδί δεν χρεώνει ποτέ δύο φορές.

SDK και εργαλεία

Επίσημα SDK για TypeScript και Python και ένα CLI. Τα SDK ξαναδοκιμάζουν με ασφάλεια με κλειδιά idempotency, περιμένουν τα αποτελέσματα, ανεβάζουν μεγάλα αρχεία σε τμήματα και επαληθεύουν τις υπογραφές των webhooks.

TypeScriptnpmjs.com (ανοίγει σε νέα καρτέλα)Node 18+, Deno, Bun και edge runtimes
Pythonpypi.org (ανοίγει σε νέα καρτέλα)Python 3.9+, μόνο η τυπική βιβλιοθήκη
CLInpmjs.com (ανοίγει σε νέα καρτέλα)Κάθε μοντέλο από το τερματικό σου
MCPΣύνδεσε τους πράκτορές σου AI με τα ίδια μοντέλα και το ίδιο υπόλοιπο.
Κάθε endpoint, πεδίο και κωδικός σφάλματος

Η διαδραστική αναφορά: δοκίμασε αιτήματα στο πρόγραμμα περιήγησης και αντίγραψε παραδείγματα κώδικα.

Πλήρης αναφορά API(ανοίγει σε νέα καρτέλα)