Τεκμηρίωση API
Ασύγχρονες εργασίες, υπογεγραμμένα webhooks, endpoints συμβατά με OpenAI. Πληρώνεις ανά εκτέλεση και οι αποτυχημένες εργασίες επιστρέφονται.
https://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. Οι αποτυχημένες και οι ακυρωμένες εργασίες επιστρέφονται.
- Long poll: το
?wait=50κρατά το αίτημα ανοιχτό έως 60 s και επιστρέφει μόλις τελειώσει η εργασία. - Webhook: ένα υπογεγραμμένο συμβάν όταν τελειώνει η εργασία.
- SDK:
{ wait: true }σε TypeScript,wait=Trueσε Python.
{
"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 του για να παραλείπεις τα διπλότυπα.
Γίνονται δεκτές μόνο δημόσιες διευθύνσεις 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 σημαίνει ότι δεν υπάρχει διαθέσιμη διαδρομή αυτή τη στιγμή.
| Κατάσταση | Κωδικοί | Τι να κάνεις |
|---|---|---|
| 400 | invalid_bodyinvalid_durationinvalid_aspect_ratiomodel_not_allowed | Ένα πεδίο λείπει ή δεν επιτρέπεται για αυτό το μοντέλο. Διόρθωσε το αίτημα· αν το στείλεις ξανά αμετάβλητο, θα αποτύχει ξανά. |
| 401 | invalid_api_keyapi_key_revokedapi_key_expired | Το κλειδί λείπει, είναι λάθος, ανακλήθηκε ή έληξε. |
| 402 | insufficient_balancekey_spend_cap_reached | Ανεπαρκές υπόλοιπο ή το κλειδί συμπλήρωσε το μηνιαίο όριό του. Δεν χρεώθηκε τίποτα. |
| 403 | insufficient_scopeip_not_allowed | Το κλειδί δεν έχει κάποιο δικαίωμα (δες required_scope) ή η IP του αιτήματος δεν είναι στη λίστα επιτρεπόμενων. |
| 404 | model_not_found | Δεν υπάρχει τέτοιο μοντέλο ή δεν είναι διαθέσιμο για το κλειδί σου. |
| 429 | rate_limited | Πάρα πολλά αιτήματα. Περίμενε τον χρόνο που δείχνει το Retry-After. |
| 503 | model_unavailable | Το μοντέλο είναι απασχολημένο ή εκτός λειτουργίας. Δοκίμασε ξανά σε λίγο ή διάλεξε άλλο μοντέλο. |
ignored_fieldsunknown_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.
/v1/modelsΛίστα μοντέλων/v1/models/{id}Λεπτομέρειες μοντέλου + εκτίμηση τιμής/v1/voicesΟι κλωνοποιημένες φωνές σου/v1/style-kitsΚιτ στυλ/v1/elementsΣτοιχεία/v1/voice-stylesΣτυλ εκφώνησης/v1/voices/cloneΚλωνοποίηση φωνής (απαιτείται συναίνεση)/v1/voices/{id}Μετονομασία κλωνοποιημένης φωνής/v1/voices/{id}Διαγραφή κλωνοποιημένης φωνής (οριστική)/v1/models/{id}/voicesΦωνές για μοντέλο ομιλίας/v1/templatesΛίστα προτύπων/v1/templates/{slug}Λήψη προτύπου και των εισόδων του/v1/templates/{slug}/runΕκτέλεση προτύπου (ασύγχρονα)/v1/templates/runs/{id}Λήψη εκτέλεσης προτύπου πολλών βημάτων/v1/templates/runs/{id}/planΕγκρίνετε ή αναδιατυπώστε το σχέδιο εκτέλεσης ενός προτύπου/v1/templates/runs/{id}/cancelΑκύρωση εκτέλεσης προτύπου πολλών βημάτων/v1/flowsΛίστα Ροών/v1/flows/{id}Λήψη Ροής και των εισόδων της/v1/flows/{id}/runΕκτέλεση Ροής (ασύγχρονα)/v1/community/templatesΛίστα προτύπων κοινότητας/v1/community/templates/{id}Λήψη προτύπου κοινότητας/v1/flows/runs/{id}Λήψη εκτέλεσης Ροής/v1/timelinesΔημιουργία χρονολογίου σκηνών/v1/timelines/{id}Λήψη χρονολογίου/v1/timelines/{id}/{action}Προεπισκόπηση, έγκριση, πλήρης ποιότητα, μοντάζ/v1/farm/jobsΛίστα εργασιών φάρμας render/v1/farm/jobs/{id}/pauseΠαύση εργασίας φάρμας render/v1/farm/jobs/{id}/resumeΣυνέχιση εργασίας φάρμας render/v1/farm/jobs/{id}Λήψη εργασίας φάρμας render/v1/video-editsΕπεξεργασία βίντεο: περικοπή, ένωση, εικόνες, κείμενο & λογότυπο, ηχητική επένδυση (ασύγχρονα, δωρεάν)/v1/generationsΛίστα δημιουργιών/v1/generationsΔημιουργία νέας δημιουργίας (ασύγχρονα)/v1/generations/{id}Λήψη δημιουργίας (long-poll με wait)/v1/generations/{id}/cancelΑκύρωση (αποδέσμευση δεσμευμένου υπολοίπου)/v1/uploadsΜεταφόρτωση αρχείου εισόδου (≤ 50 MB)/v1/uploads/sessionsΈναρξη τμηματικής μεταφόρτωσης (έως 2 GB)/v1/uploads/sessions/{id}Κατάσταση συνεδρίας (ληφθέντα τμήματα, εύρη που λείπουν)/v1/uploads/sessions/{id}Ακύρωση τμηματικής μεταφόρτωσης/v1/uploads/sessions/{id}/chunks/{index}Μεταφόρτωση ενός τμήματος (ακατέργαστο body)/v1/uploads/sessions/{id}/completeΟλοκλήρωση τμηματικής μεταφόρτωσης/v1/accountΛογαριασμός, κλειδί και υπόλοιπο/v1/account/balanceΥπόλοιπο (USD)/v1/account/usageΧρήση ανά ημέρα και μοντέλο/v1/webhooksΛίστα webhooks/v1/webhooksΔημιουργία webhook (το secret επιστρέφεται μία φορά)/v1/webhooks/{id}Διαγραφή webhook/v1/webhooks/{id}/deliveriesΑρχείο καταγραφής παραδόσεων/v1/reseller/subtenantsΛίστα πελατών σου (υπο-μισθωτές)/v1/reseller/subtenantsΔημιουργία πελάτη (υπο-μισθωτής)/v1/reseller/subtenants/{id}/keysΔημιουργία κλειδιού API για πελάτη (το secret επιστρέφεται μία φορά)/v1/reseller/usageΧρήση και κόστος χονδρικής ανά πελάτη/v1/chat/completionsChat completion (σχήμα OpenAI)/v1/images/generationsΔημιουργία εικόνας (σχήμα OpenAI, σύγχρονα ≤ 90 s)/v1/boards/{board_id}/approvalsΛίστα αιτημάτων έγκρισης σε πίνακα/v1/boards/{board_id}/approvals/{request_id}Λήψη αιτήματος έγκρισης/v1/boards/{board_id}/approvals/{request_id}/decideΈγκριση επιλογής ή αίτημα αλλαγών/v1/plans/readΑνάγνωση κάτοψης/v1/panoramas/finishΟλοκλήρωση πανοράματος 360°/v1/flows/runs/{id}/cancelΑκύρωση εκτέλεσης ροής/v1/architecture/projectsΛίστα έργων Architecture Studio/v1/architecture/projectsΔημιουργία έργου/v1/architecture/projects/{id}Λήψη έργου και των στοιχείων του/v1/architecture/projects/{id}/itemsΠροσθήκη σε έργο/v1/architecture/projects/{id}/complianceΛίστα ετικετών «Ενδεικτική εικόνα»/v1/architecture/projects/{id}/complianceΠροσθήκη ετικέτας «Ενδεικτική εικόνα»/v1/architecture/projects/{id}/compliance/{stamp}Απόσυρση ετικέτας/v1/architecture/projects/{id}/productsΛίστες προϊόντων μιας εικόνας/v1/architecture/projects/{id}/productsΔημιουργία λίστας προϊόντων από render/v1/architecture/products/{id}Λήψη ή κατέβασμα λίστας προϊόντωνΤιμές
Δολάρια ανά εκτέλεση, από το ίδιο υπόλοιπο με το πλάνο σου. Αυτές είναι οι τρέχουσες τιμές με τις προεπιλεγμένες ρυθμίσεις· κάθε σελίδα μοντέλου δείχνει όλες τις τιμές ανά ανάλυση και διάρκεια.
| Μοντέλο | Εργασία | 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 |
Κλειδιά και όρια
Κάθε κλειδί έχει τα δικά του δικαιώματα, ρυθμό και όριο δαπανών. Τα headers της απόκρισης δείχνουν τι απομένει.
X-RateLimit-*key_spend_cap_reachedSDK και εργαλεία
Επίσημα SDK για TypeScript και Python και ένα CLI. Τα SDK ξαναδοκιμάζουν με ασφάλεια με κλειδιά idempotency, περιμένουν τα αποτελέσματα, ανεβάζουν μεγάλα αρχεία σε τμήματα και επαληθεύουν τις υπογραφές των webhooks.
Η διαδραστική αναφορά: δοκίμασε αιτήματα στο πρόγραμμα περιήγησης και αντίγραψε παραδείγματα κώδικα.
