Aller à la documentation
API v1

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.

Télécharger Markdown

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
curl --fail-with-body --request GET \
  "$METAGHOST_BASE_URL/credits" \
  --header "Authorization: Bearer $METAGHOST_API_KEY"
Python / Node.js
Python
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
// 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.

Terminal
python3 quickstart.py image.jpg result.jpg --max-credits 20
Télécharger quickstart.py
  1. POST /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.
  2. 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.
  3. 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.
  4. 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

cURL
# 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

cURL
# 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

cURL
# 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

cURL
# 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

cURL
# 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

cURL
# 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

cURL
# 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

cURL
# 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

cURL
# 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

cURL
# 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

POST/batches/{batchId}/cancel

Permissions · batches:write, jobs:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/jobs/{jobId}

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

PATCH/studio-templates/{templateId}

Permissions · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/studio-templates/{templateId}

Permissions · projects:write, 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

POST/transcripts/{transcriptId}/start

Permissions · batches:write, jobs:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/captions/font-preview

Permissions · jobs:read

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

DELETE/downloads/{downloadId}

Permissions · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/downloads/{downloadId}/result

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

POST/drive/authorizations

Permissions · drive:write, drive:read

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/authorizations/{authorizationId}

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

GET/drive/connections/{connectionId}

Permissions · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/drive/connections/{connectionId}

Permissions · drive:write, 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

DELETE/team/presets/{presetId}

Permissions · teams:write, teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/team/presets/{presetId}/lock

Permissions · teams:write, teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

Compte et limites

GET/performance

Permissions · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

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.