API Cloud MetaGhost
Traitez des images et des vidéos depuis votre serveur. Envoyez un fichier, acceptez son devis en crédits et récupérez le résultat.
Démarrage rapide
Dans votre espace abonné, ouvrez Cloud API et créez une clé avec la permission « Read credits ». Définissez METAGHOST_API_KEY et METAGHOST_BASE_URL sur votre serveur avec les valeurs affichées. Cette première requête lit le solde sans dépenser de crédits.
curl --fail-with-body --request GET \
"$METAGHOST_BASE_URL/credits" \
--header "Authorization: Bearer $METAGHOST_API_KEY"Python / Node.js
import os
import json
import urllib.request
base = os.environ["METAGHOST_BASE_URL"].rstrip("/")
headers = {
"Authorization": "Bearer " + os.environ["METAGHOST_API_KEY"]
}
request = urllib.request.Request(
base + "/credits",
method="GET", headers=headers
)
with urllib.request.urlopen(request, timeout=30) as response:
print(json.load(response))// Node.js 24: run on your server.
const base = process.env.METAGHOST_BASE_URL?.replace(/\/$/, "");
const token = process.env.METAGHOST_API_KEY;
if (!base || !token) throw new Error("Missing API configuration");
const response = await fetch(base + "/credits", {
method: "GET",
headers: {
"Authorization": `Bearer ${token}`
},
signal: AbortSignal.timeout(30_000),
});
const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result);Business et Scale incluent l’API par défaut. Les droits de l’équipe et les accès déjà accordés s’appliquent aussi. Choisissez « Never » pour conserver la clé à chaque renouvellement. Elle fonctionne uniquement tant que le compte ou l’équipe d’origine a accès à l’API. Vous pouvez la révoquer à tout moment. Conservez-la côté serveur et envoyez-la comme jeton Bearer.
Traiter une image
Cet exemple Python 3.10+ envoie un JPEG de 5 Mio maximum et enregistre le résultat dans un nouveau fichier. Donnez à sa clé Cloud les permissions assets:write, quotes:write, batches:write et jobs:read. La commande lance le traitement uniquement si son devis respecte le plafond de crédits que vous fixez.
python3 quickstart.py image.jpg result.jpg --max-credits 20POST /assets· Créez un envoi, transférez les octets vers l’URL signée avec ses en-têtes, puis finalisez et attendez l’état ready.POST /quotes· Demandez un devis pour une sortie avec l’identifiant du média vérifié, sa version et l’opération image.spoof.simple.POST /batches· Envoyez l’identifiant du devis et le montant accepté. Conservez l’Idempotency-Key et le corps exact de la requête pour reprendre après une réponse perdue.GET /results/{resultId}· Une fois le lot terminé avec succès, consultez ses tâches, récupérez l’URL signée du résultat et vérifiez le SHA-256 avant d’enregistrer le fichier.
Consultez GET /capabilities pour connaître les opérations et les limites actives. SynthID vidéo accepte jusqu’à 10 secondes par fichier source, y compris dans Advanced et Spoof Pro quand ils utilisent SynthID.
Coût en crédits
Le traitement simple d’une image coûte 10 crédits par mégapixel et par sortie, arrondis au crédit supérieur. En vidéo simple à 1920 × 1080 et 30 images/s, chaque seconde coûte 3 crédits par sortie.
- 1 MP
- 10 crédits
- 1080p · 10 s
- 30 crédits
- 1080p · 60 s
- 180 crédits
La résolution, la cadence, le nombre de sorties et les options IA modifient le total. Le devis du serveur fait foi. La création du lot réserve les crédits. L’historique montre les débits des traitements terminés.
Référence API
Utilisez l’URL de base de votre espace abonné, qui se termine par /api/cloud/v1.
Recherchez par chemin, méthode ou permission. Ouvrez une route pour consulter ses droits et ses schémas. Les routes de démarrage incluent des exemples.
123 routes
Routes de démarrage
GET/credits
Permissions · credits:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
"$METAGHOST_BASE_URL/credits" \
--header "Authorization: Bearer $METAGHOST_API_KEY"GET/capabilities
Permissions · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
"$METAGHOST_BASE_URL/capabilities" \
--header "Authorization: Bearer $METAGHOST_API_KEY"POST/assets
Permissions · assets:write
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request POST \
"$METAGHOST_BASE_URL/assets" \
--header "Authorization: Bearer $METAGHOST_API_KEY" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: example-request-0001" \
--data '{
"filename": "image.jpg",
"byteLength": 12345,
"sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"mediaType": "image/jpeg"
}'POST/assets/{assetId}/finalize
Permissions · assets:write
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request POST \
"$METAGHOST_BASE_URL/assets/{assetId}/finalize" \
--header "Authorization: Bearer $METAGHOST_API_KEY" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: example-request-0001" \
--data '{
"byteLength": 12345,
"sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}'GET/assets/{assetId}
Permissions · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
"$METAGHOST_BASE_URL/assets/{assetId}" \
--header "Authorization: Bearer $METAGHOST_API_KEY"POST/quotes
Permissions · quotes:write
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request POST \
"$METAGHOST_BASE_URL/quotes" \
--header "Authorization: Bearer $METAGHOST_API_KEY" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: example-request-0001" \
--data '{
"operation": "image.spoof.simple",
"inputs": [
{
"asset": {
"assetId": "ca_00000000000000000000000000000001",
"version": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
"variants": 1
}
],
"options": {}
}'POST/batches
Permissions · batches:write, jobs:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request POST \
"$METAGHOST_BASE_URL/batches" \
--header "Authorization: Bearer $METAGHOST_API_KEY" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: example-request-0001" \
--data '{
"quoteId": "cq_00000000000000000000000000000001",
"maxCredits": 10
}'GET/batches/{batchId}
Permissions · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
"$METAGHOST_BASE_URL/batches/{batchId}" \
--header "Authorization: Bearer $METAGHOST_API_KEY"GET/batches/{batchId}/jobs
Permissions · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
"$METAGHOST_BASE_URL/batches/{batchId}/jobs" \
--header "Authorization: Bearer $METAGHOST_API_KEY"GET/results/{resultId}
Permissions · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
"$METAGHOST_BASE_URL/results/{resultId}" \
--header "Authorization: Bearer $METAGHOST_API_KEY"Fichiers, presets et tâches
GET/jobs/{jobId}/caption-review
Permissions · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PATCH/jobs/{jobId}/caption-review
Permissions · batches:write, jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/jobs/{jobId}/caption-review/submit
Permissions · batches:write, jobs:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/presets/import
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/presets/export
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/presets
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/presets
Permissions · projects:write, projects:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/presets/{presetId}
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PATCH/presets/{presetId}
Permissions · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/presets/{presetId}
Permissions · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/presets/{presetId}/rename
Permissions · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/catalog
Permissions · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/assets/{assetId}
Permissions · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/quotes/{quoteId}
Permissions · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Studio et bibliothèque
POST/library-rebuilds
Permissions · projects:write, projects:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-rebuilds/{rebuildId}
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/library-rebuilds/{rebuildId}
Permissions · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-items/{libraryId}/preview
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/library-items
Permissions · projects:write, projects:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-items
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/library-uploads
Permissions · projects:write, projects:read, assets:write
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/library-uploads/{assetId}/finalize
Permissions · projects:write, projects:read, assets:write
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-items/stats
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-items/{libraryId}
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PATCH/library-items/{libraryId}
Permissions · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/library-items/{libraryId}
Permissions · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-items/{libraryId}/content
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/studio-imports
Permissions · projects:write, projects:read, assets:write
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/studio-transfers/{transferId}
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/studio-transfers/{transferId}
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/studio-transfers/{transferId}/finalize
Permissions · projects:write, projects:read, assets:write
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/studio-transfers/{transferId}/result
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/studio-templates/{templateId}/export
Permissions · projects:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/studio-templates
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/studio-templates
Permissions · projects:write, projects:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/studio-templates/{templateId}/preview
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PUT/studio-templates/{templateId}/preview
Permissions · projects:write, projects:read, jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/studio-templates/{templateId}
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Sous-titres et traduction
POST/translations
Permissions · projects:write, projects:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/translations/{translationId}
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/translations/{translationId}
Permissions · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/translations/{translationId}/result
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/caption-projects
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/caption-projects
Permissions · projects:write, projects:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/caption-projects/{projectId}
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PATCH/caption-projects/{projectId}
Permissions · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/caption-projects/{projectId}
Permissions · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/caption-projects/{projectId}/subtitles
Permissions · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/transcripts
Permissions · quotes:write, assets:write, jobs:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/transcripts/{transcriptId}
Permissions · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/transcripts/{transcriptId}
Permissions · quotes:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Téléchargements
POST/download-sessions
Permissions · assets:write
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/download-sessions
Permissions · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/download-sessions/{sessionId}
Permissions · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/download-sessions/{sessionId}
Permissions · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/download-batches
Permissions · assets:write
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/download-batches/{batchId}
Permissions · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/download-batches/{batchId}
Permissions · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/downloads
Permissions · assets:write
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/downloads/{downloadId}
Permissions · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Google Drive
POST/drive/connections/{connectionId}/outputs
Permissions · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/outputs/{collectionId}
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/outputs/{collectionId}
Permissions · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/outputs/{collectionId}/items
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/outputs/{collectionId}/recover
Permissions · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/connections/{connectionId}/inputs
Permissions · drive:write, drive:read, assets:write
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/inputs/{collectionId}
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/inputs/{collectionId}
Permissions · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/inputs/{collectionId}/items
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/connections/{connectionId}/transfers
Permissions · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/transfers/{transferId}
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/transfers/{transferId}
Permissions · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/transfers/{transferId}/recover
Permissions · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/connections/{connectionId}/mutations
Permissions · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/mutations/{mutationId}
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/mutations/{mutationId}
Permissions · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/mutations/{mutationId}/reconcile
Permissions · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/connections/{connectionId}/thumbnail
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/connections/{connectionId}/pickers
Permissions · drive:write, drive:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/pickers/{pickerId}
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/pickers/{pickerId}
Permissions · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/pickers/{pickerId}/items
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/connections/{connectionId}/favorites
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PUT/drive/connections/{connectionId}/favorites
Permissions · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/connections/{connectionId}/favorites
Permissions · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/connections/{connectionId}/files/query
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/connections/{connectionId}/file
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/connection
Permissions · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Équipes
GET/team/activity
Permissions · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/activity/status
Permissions · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/members
Permissions · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/invitations
Permissions · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/permissions
Permissions · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/audit
Permissions · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/presets
Permissions · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/team/presets
Permissions · teams:write, teams:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/presets/{presetId}
Permissions · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PATCH/team/presets/{presetId}
Permissions · teams:write, teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Compte et limites
Dépannage
- 401
- Vérifiez que la clé Cloud est renseignée, valide et toujours active.
- 403
- Vérifiez l’abonnement, les droits de l’équipe et les permissions de la clé.
- 409
- Vérifiez le devis. Si la réponse a été perdue, reprenez la requête exacte avec son Idempotency-Key d’origine.
- 429
- Attendez le délai indiqué dans Retry-After avant de réessayer.
MCP Cloud
Copiez l’URL MCP depuis la page Cloud API de votre espace abonné. Dans votre assistant, ajoutez un serveur MCP distant, choisissez Streamable HTTP et collez l’URL. Saisissez votre clé API Cloud dans le champ du connecteur prévu pour le jeton Bearer. Le logiciel peut rester fermé.
Utilisez metaghost_cloud_getCredits avec « Read credits » pour vérifier la connexion. Donnez à la clé « Process media » pour créer des devis, lancer des lots et lire les résultats. Ajoutez « Projects » ou « Google Drive » pour les parcours correspondants. Demandez un devis avant de lancer un lot et renseignez maxCredits. Envoyez le fichier avec l’URL de téléversement signée ou utilisez un fichier déjà autorisé dans Google Drive. Le MCP renvoie des liens de résultat temporaires.
La reprise Drive permet de vérifier un envoi existant ou de reprendre son transfert. Ouvrez dans votre navigateur les liens de consentement et de sélection renvoyés par l’assistant, puis revenez dans l’assistant pour continuer.
Pour connecter une session authentifiée du Downloader, importez son fichier de cookies directement via POST /download-sessions, en dehors de l’assistant. Le MCP pourra ensuite lister, utiliser et révoquer la session par son identifiant.