MetaGhost Cloud API
Process images and videos from your server. Send a file, approve a credit quote and retrieve the result.
Quickstart
In your account, open Cloud API and create a key with Read credits permission. Set METAGHOST_API_KEY and METAGHOST_BASE_URL on your server using the values shown there. This first request reads the balance without spending credits.
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 and Scale include API access by default. Team permissions and existing grants also apply. Choose Never to keep your key across renewals. It works only while the original account or team has API access. You can revoke it at any time. Store the key on your server and send it as a Bearer token.
Process an image
This Python 3.10+ example sends one JPEG up to 5 MiB and saves the result to a new file. Give its Cloud key the assets:write, quotes:write, batches:write and jobs:read permissions. The command submits the batch only if its quote fits the credit limit you set.
python3 quickstart.py image.jpg result.jpg --max-credits 20POST /assets· Create an upload, send the bytes to the signed URL with its required headers, then finalize and wait for ready.POST /quotes· Quote one output using the verified asset ID, version and the image.spoof.simple operation.POST /batches· Submit the quote ID and approved amount. Save the Idempotency-Key and exact request body so a lost response can be recovered.GET /results/{resultId}· After the batch succeeds, read its jobs, get the signed download URL and verify the SHA-256 before saving.
Check GET /capabilities for active operations and limits. Video SynthID accepts up to 10 seconds per source, including in Advanced and Spoof Pro when they run SynthID.
Credit pricing
Simple images cost 10 credits per megapixel per output, rounded up to a whole credit. Simple video costs 3 credits per second per output at 1920 × 1080 and 30 fps.
- 1 MP
- 10 credits
- 1080p · 10 s
- 30 credits
- 1080p · 60 s
- 180 credits
Resolution, frame rate, outputs and AI options affect the total. The server quote is authoritative. Submitting a batch reserves credits. Recent API usage shows charges for completed work.
API reference
Use the base URL from your account ending in /api/cloud/v1.
Search by path, method or scope. Open a route to view its permissions and schemas. Quickstart routes include examples.
123 endpoints
Quickstart routes
GET/credits
Scopes · 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
Scopes · 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
Scopes · 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
Scopes · 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}
Scopes · 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
Scopes · 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
Scopes · 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}
Scopes · 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
Scopes · 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}
Scopes · 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"Files, presets and jobs
GET/jobs/{jobId}/caption-review
Scopes · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PATCH/jobs/{jobId}/caption-review
Scopes · batches:write, jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/jobs/{jobId}/caption-review/submit
Scopes · batches:write, jobs:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/presets/import
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/presets/export
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/presets
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/presets
Scopes · projects:write, projects:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/presets/{presetId}
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PATCH/presets/{presetId}
Scopes · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/presets/{presetId}
Scopes · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/presets/{presetId}/rename
Scopes · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/assets/{assetId}
Scopes · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/quotes/{quoteId}
Scopes · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Studio and media library
POST/library-rebuilds
Scopes · projects:write, projects:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-rebuilds/{rebuildId}
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/library-rebuilds/{rebuildId}
Scopes · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-items/{libraryId}/preview
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/library-items
Scopes · projects:write, projects:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-items
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/library-uploads
Scopes · 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
Scopes · projects:write, projects:read, assets:write
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-items/stats
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-items/{libraryId}
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PATCH/library-items/{libraryId}
Scopes · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/library-items/{libraryId}
Scopes · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/library-items/{libraryId}/content
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/studio-imports
Scopes · projects:write, projects:read, assets:write
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/studio-transfers/{transferId}
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/studio-transfers/{transferId}
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/studio-transfers/{transferId}/finalize
Scopes · 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
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/studio-templates/{templateId}/export
Scopes · projects:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/studio-templates
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/studio-templates
Scopes · projects:write, projects:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/studio-templates/{templateId}/preview
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PUT/studio-templates/{templateId}/preview
Scopes · projects:write, projects:read, jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/studio-templates/{templateId}
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Captions and translation
POST/translations
Scopes · projects:write, projects:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/translations/{translationId}
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/translations/{translationId}
Scopes · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/translations/{translationId}/result
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/caption-projects
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/caption-projects
Scopes · projects:write, projects:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/caption-projects/{projectId}
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PATCH/caption-projects/{projectId}
Scopes · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/caption-projects/{projectId}
Scopes · projects:write, projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/caption-projects/{projectId}/subtitles
Scopes · projects:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/transcripts
Scopes · quotes:write, assets:write, jobs:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/transcripts/{transcriptId}
Scopes · jobs:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/transcripts/{transcriptId}
Scopes · quotes:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Downloader
POST/download-sessions
Scopes · assets:write
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/download-sessions
Scopes · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/download-sessions/{sessionId}
Scopes · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/download-sessions/{sessionId}
Scopes · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/download-batches
Scopes · assets:write
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/download-batches/{batchId}
Scopes · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/download-batches/{batchId}
Scopes · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/downloads
Scopes · assets:write
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/downloads/{downloadId}
Scopes · assets:write
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Google Drive
POST/drive/connections/{connectionId}/outputs
Scopes · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/outputs/{collectionId}
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/outputs/{collectionId}
Scopes · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/outputs/{collectionId}/items
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/outputs/{collectionId}/recover
Scopes · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/connections/{connectionId}/inputs
Scopes · drive:write, drive:read, assets:write
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/inputs/{collectionId}
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/inputs/{collectionId}
Scopes · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/inputs/{collectionId}/items
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/connections/{connectionId}/transfers
Scopes · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/transfers/{transferId}
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/transfers/{transferId}
Scopes · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/transfers/{transferId}/recover
Scopes · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/connections/{connectionId}/mutations
Scopes · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/mutations/{mutationId}
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/mutations/{mutationId}
Scopes · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/mutations/{mutationId}/reconcile
Scopes · drive:write, drive:read
HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/connections/{connectionId}/thumbnail
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/connections/{connectionId}/pickers
Scopes · drive:write, drive:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/pickers/{pickerId}
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/pickers/{pickerId}
Scopes · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/pickers/{pickerId}/items
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/connections/{connectionId}/favorites
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PUT/drive/connections/{connectionId}/favorites
Scopes · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
DELETE/drive/connections/{connectionId}/favorites
Scopes · drive:write, drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/drive/connections/{connectionId}/files/query
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/connections/{connectionId}/file
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/drive/connection
Scopes · drive:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Teams
GET/team/activity
Scopes · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/activity/status
Scopes · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/members
Scopes · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/invitations
Scopes · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/permissions
Scopes · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/audit
Scopes · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/presets
Scopes · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
POST/team/presets
Scopes · teams:write, teams:read
HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
GET/team/presets/{presetId}
Scopes · teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
PATCH/team/presets/{presetId}
Scopes · teams:write, teams:read
HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503
Account and limits
Troubleshooting
- 401
- Check that the Cloud key is present, valid and still active.
- 403
- Check your subscription, team permissions and the scopes of the key.
- 409
- Check the quote and replay the exact request with its original Idempotency-Key if the response was lost.
- 429
- Wait for the delay in Retry-After before making another request.
Cloud MCP
Copy the MCP URL from the Cloud API page in your account. In your assistant, add a remote MCP server, choose Streamable HTTP and paste the URL. Enter your Cloud API key in the connector’s Bearer token field. The Desktop app can stay closed.
Use metaghost_cloud_getCredits with Read credits to check the connection. Give the key Process media to use quotes, batches and results. Add Projects or Google Drive for the corresponding workflows. Get a quote before starting a batch and set maxCredits. Upload the file with the signed upload URL or use a file already granted through Google Drive. The MCP returns temporary result links.
Drive recovery can verify an existing delivery or resume its upload. Open the consent and Picker links returned by the assistant in your browser, then return to the assistant to continue.
To connect an authenticated Downloader session, import its cookie file directly with POST /download-sessions outside the assistant. The MCP can then list, use and revoke the session by ID.