curl --request POST \
--url https://api.studio.us.phrase.com/v1/projects \
--header 'Content-Type: multipart/form-data' \
--header 'X-API-Key: <api-key>' \
--form sourceLanguage=en \
--form 'subtitleProfiles={
"subtitleProfileId": "00000000-0000-0000-0000-000000000001",
"languageCode": "en"
}' \
--form summary=false \
--form customAttributes=true \
--form 'insights[0]=00000000-0000-0000-0000-000000000002' \
--form 'insights[1]=00000000-0000-0000-0000-000000000003' \
--form 'glossary={
"id": "00000000-0000-0000-0000-000000000004",
"content": "term1\\nterm2\\nterm3"
}' \
--form 'safeCommunications[0]=00000000-0000-0000-0000-000000000005' \
--form 'safeCommunications[1]=00000000-0000-0000-0000-000000000006' \
--form 'pronunciations={
"pronunciationId": "00000000-0000-0000-0000-000000000007",
"languageCode": "en"
}'{
"id": "01jzmvc20cjq5hj5saa96ttp2x"
}Create Project
Creates an empty project and redirects the client to the upload service to upload files. After upload completion, the service will finalize the project automatically. Direct file uploads are more robust and recommended over providing fileUrls.
This endpoint does not accept translation or dubbing languages — a project is created transcription-only. Once transcription completes, call POST /v1/projects/{projectId}/recordings/{recordingId}/translate to add translation languages, then POST /v1/projects/{projectId}/recordings/{recordingId}/dubbing to add dubbing languages.
Upload behavior and limits:
- 10-minute inactivity timeout per upload stream.
- If the client connection drops, the upload is aborted and cannot resume; retry from the start.
- Multi-hour uploads are supported as long as data keeps flowing and the connection stays open.
curl --request POST \
--url https://api.studio.us.phrase.com/v1/projects \
--header 'Content-Type: multipart/form-data' \
--header 'X-API-Key: <api-key>' \
--form sourceLanguage=en \
--form 'subtitleProfiles={
"subtitleProfileId": "00000000-0000-0000-0000-000000000001",
"languageCode": "en"
}' \
--form summary=false \
--form customAttributes=true \
--form 'insights[0]=00000000-0000-0000-0000-000000000002' \
--form 'insights[1]=00000000-0000-0000-0000-000000000003' \
--form 'glossary={
"id": "00000000-0000-0000-0000-000000000004",
"content": "term1\\nterm2\\nterm3"
}' \
--form 'safeCommunications[0]=00000000-0000-0000-0000-000000000005' \
--form 'safeCommunications[1]=00000000-0000-0000-0000-000000000006' \
--form 'pronunciations={
"pronunciationId": "00000000-0000-0000-0000-000000000007",
"languageCode": "en"
}'{
"id": "01jzmvc20cjq5hj5saa96ttp2x"
}Authorizations
Query Parameters
Project title
Body
Source language code — the language actually spoken in the recording. Always specify one explicitly.
am, am-et, ar, ar-001, ar-145, ar-ae, ar-arabizi, ar-bh, ar-dj, ar-dz, ar-eg, ar-eh, ar-er, ar-il, ar-iq, ar-jo, ar-km, ar-kw, ar-latn, ar-lb, ar-ly, ar-ma, ar-mod, ar-mr, ar-om, ar-ps, ar-qa, ar-sa, ar-sd, ar-sn, ar-so, ar-ss, ar-sy, ar-tn, ar-ye, as, as-in, as-latn, az, az-arab, az-arab-ir, az-az, az-cyrl, az-cyrl-az, az-latn, az-latn-az, ba, ba-ru, bg, bg-bg, bg-latn, bg-latn-bg, br, ca, ca-ad, ca-es, ca-es-valencia, cs, cs-cz, cy, cy-gb, da, da-dk, da-fo, da-gl, de, de-at, de-be, de-ch, de-de, de-dk, de-it, de-li, de-lu, de-nl, el, el-cy, el-gr, el-latn, el-latn-gr, en, en-001, en-029, en-039, en-150, en-151, en-154, en-155, en-ae, en-af, en-ag, en-ai, en-al, en-am, en-aq, en-ar, en-as, en-au, en-aw, en-ax, en-az, en-ba, en-bb, en-bd, en-be, en-bh, en-bl, en-bm, en-bn, en-bq, en-br, en-bs, en-bt, en-bw, en-bz, en-ca, en-cc, en-ch, en-ck, en-cl, en-cn, en-co, en-cw, en-cx, en-cy, en-cz, en-de, en-dk, en-dm, en-dz, en-eg, en-er, en-es, en-et, en-fi, en-fj, en-fk, en-fm, en-fo, en-fr, en-gb, en-gd, en-ge, en-gf, en-gg, en-gh, en-gi, en-gl, en-gm, en-gp, en-gq, en-gr, en-gs, en-gu, en-gw, en-gy, en-hk, en-hm, en-ht, en-hu, en-id, en-ie, en-il, en-im, en-in, en-io, en-iq, en-is, en-it, en-je, en-jm, en-jo, en-jp, en-ke, en-kh, en-ki, en-km, en-kn, en-kr, en-kw, en-ky, en-kz, en-la, en-lb, en-lc, en-lk, en-lr, en-ls, en-ly, en-ma, en-me, en-mg, en-mh, en-mk, en-mm, en-mn, en-mo, en-mp, en-mq, en-ms, en-mt, en-mu, en-mv, en-mw, en-mx, en-my, en-mz, en-na, en-nf, en-ng, en-nl, en-no, en-np, en-nr, en-nu, en-nz, en-om, en-pe, en-pg, en-ph, en-pk, en-pm, en-pn, en-pr, en-pt, en-pw, en-qa, en-rs, en-ru, en-rw, en-sa, en-sb, en-sc, en-sd, en-se, en-sg, en-sh, en-si, en-sk, en-sl, en-so, en-sr, en-ss, en-sx, en-sy, en-sz, en-tc, en-th, en-tk, en-tl, en-tm, en-tn, en-to, en-tr, en-tt, en-tv, en-tw, en-tz, en-ug, en-um, en-us, en-vc, en-vg, en-vi, en-vn, en-vu, en-wf, en-ws, en-ye, en-za, en-zm, en-zw, es, es-001, es-419, es-ad, es-ar, es-aw, es-bb, es-bo, es-bz, es-cl, es-co, es-cr, es-cu, es-do, es-ec, es-es, es-gq, es-gt, es-hn, es-ic, es-jm, es-mx, es-ni, es-pa, es-pe, es-pr, es-py, es-sv, es-tt, es-us, es-uy, es-ve, et, et-ee, eu, eu-es, fa, fa-af, fa-ir, fa-latn, fa-latn-ir, fi, fi-fi, fi-se, fo, fo-fo, fr, fr-001, fr-002, fr-011, fr-015, fr-017, fr-ad, fr-be, fr-bf, fr-bi, fr-bj, fr-bl, fr-ca, fr-cd, fr-cf, fr-cg, fr-ch, fr-ci, fr-cm, fr-dj, fr-dz, fr-fr, fr-ga, fr-gf, fr-gn, fr-gp, fr-gq, fr-ht, fr-km, fr-lb, fr-lu, fr-ma, fr-mc, fr-mf, fr-mg, fr-ml, fr-mq, fr-mr, fr-mu, fr-nc, fr-ne, fr-pf, fr-pm, fr-re, fr-rw, fr-sc, fr-sn, fr-td, fr-tf, fr-tg, fr-tn, fr-wf, fr-yt, gu, gu-in, ha, ha-latn-ne, ha-latn-ng, he, he-il, he-ru, hi, hi-fj, hi-in, hi-latn, hu, hu-hu, hy, hy-am, hy-latn, hy-latn-am, id, id-id, is, is-is, it, it-ch, it-it, it-sm, it-va, ja, ja-jp, ja-us, jw, ka, ka-ge, kk, kk-cyrl-kz, kk-kz, kk-latn, km, km-kh, km-vn, kn, kn-in, ko, ko-kp, ko-kr, ko-us, la, lb, lb-lu, lv, lv-lv, lv-ru, ml, ml-in, mn, mn-mn, mn-mong, mn-mong-cn, mr, mr-in, mt, mt-mt, ne, ne-np, nl, nl-001, nl-be, nl-cw, nl-nl, nl-sr, nn, nn-no, no, no-no, no-no-ny, pa, pa-arab, pa-arab-pk, pa-ca, pa-guru, pa-guru-in, pa-guru-pk, pa-in, pa-pk, pl, pl-pl, ps, ps-af, pt, pt-001, pt-ao, pt-br, pt-cv, pt-gw, pt-mz, pt-pt, pt-st, pt-tl, pt-us, ro, ro-md, ro-ro, ru, ru-by, ru-ee, ru-il, ru-kg, ru-kz, ru-latn, ru-latn-ru, ru-lt, ru-lv, ru-md, ru-ru, ru-tj, ru-tm, ru-ua, ru-uz, si, si-lk, sk, sk-sk, sl, sl-si, sl-sl, sq, sq-al, sq-mk, sq-xk, sr, sr-ba, sr-cyrl, sr-cyrl-ba, sr-cyrl-me, sr-cyrl-rs, sr-latn, sr-latn-ba, sr-latn-cs, sr-latn-me, sr-latn-rs, sr-me, sr-rs, su, sv, sv-ax, sv-fi, sv-se, sv-sk, sw, sw-cd, sw-ke, sw-tz, sw-ug, ta, ta-in, ta-latn, ta-latn-in, ta-lk, ta-my, ta-sg, te, te-in, te-latn, te-latn-in, th, th-th, tl, tl-ph, tr, tr-tr, tt, tt-ru, uk, uk-latn, uk-latn-ua, uk-pl, uk-ua, ur, ur-bd, ur-in, ur-latn, ur-lk, ur-pk, uz, uz-cyrl, uz-cyrl-uz, uz-latn, uz-latn-uz, uz-uz, vi, vi-us, vi-vn, yue, zh, zh-cn, zh-hans, zh-hans-cn, zh-hans-hk, zh-hans-kr, zh-hans-my, zh-hans-sg, zh-hans-us, zh-hant, zh-hant-cn, zh-hant-hk, zh-hant-tw, zh-hk, zh-mo, zh-my, zh-sg, zh-tw Array of subtitle profile selections. In multipart, provide this as a JSON array string.
Show child attributes
Show child attributes
Additional languages that may be spoken in the recording besides sourceLanguage (for recordings that switch between languages). Provide as a JSON array string in multipart. sourceLanguage and duplicates are ignored.
Enable summary generation
Enable custom attributes extraction
Requested insight IDs (UUID v4). Provide as JSON array or JSON string.
Glossary configuration (JSON object or JSON string). When provided as an object in multipart form, use JSON string representation.
Show child attributes
Show child attributes
Safe communication IDs (UUID v4). Provide as JSON array or JSON string.
Pronunciations to apply. In multipart, provide as JSON array string.
Show child attributes
Show child attributes
External file URLs to import. Provide as JSON array or JSON string. If provided, uploaded files in this request are ignored for processing (but still count towards the 5-item limit).
One or more files to upload (max 5 total across files + fileUrls). Ignored for processing when fileUrls are provided (but still count towards the limit).
Response
Upload accepted and project initialized
Project ID
Was this page helpful?