Partner API
Jalankan workflow Morphic dari sistem Anda sendiri melalui HTTPS.
Partner API memulai sebuah alur kerja Morphic dari perangkat lunak Anda sendiri. Anda membaca kontrak input suatu alur kerja, memulai run dengan input Anda, lalu mengikuti run tersebut — dengan polling atau menerima webhook — hingga alur kerja itu mengembalikan aset-aset jadinya.
Akses awal. v1 sudah tersedia. Nama field dan batasan masih bisa berubah — bangun integrasi dengannya dan beri tahu kami apa yang tidak cocok.
Apa itu alur kerja
Alur kerja adalah resep yang ditulis tim Anda di Morphic Studio: rangkaian langkah generasi yang menerima input bernama dan menghasilkan aset jadi. API ini memulainya dari sistem Anda dan mengumpulkan keluarannya. API ini tidak menulis alur kerja — itu tetap dilakukan di Studio, tempat orang-orang yang memiliki keputusan kreatif bekerja.
Bentuk integrasi
sequenceDiagram
participant You as Sistem Anda
participant M as API Morphic
Anda->>M: GET input alur kerja
M-->>Anda: input yang perlu dikumpulkan
Anda->>M: POST run alur kerja
M-->>Anda: 202 + ID run
loop sampai terminal
Anda->>M: GET run alur kerja
M-->>Anda: status, lalu aset
endYang Anda perlukan sebelum memulai
| Nilai | Dari mana asalnya |
|---|---|
| Kunci API | seorang admin organisasi Morphic Anda membuatnya di Studio; kunci hanya ditampilkan sekali |
| URL dasar | https://api.morphic.com/v1/partner — juga ditampilkan di halaman kunci API di Studio; lihat Lingkungan untuk staging |
org_id | organisasi Morphic Anda — ditampilkan, dengan tombol Salin, di halaman kunci API di Studio |
project_id | kanvas tempat run masuk: buka di Studio dan salin ID dari URL-nya, …/editor/<project_id>/canvas (ID di sebuah /projects/… URL adalah yang berbeda) |
workflow_id | alur kerja yang diminta untuk Anda jalankan |
Tidak ada unggahan file
Anda tidak pernah mengunggah byte kepada kami. Setiap input file adalah sebuah tautan HTTPS publik yang kami ambil dan verifikasi — lihat Mengirim file melalui URL. Ini mempertahankan satu kontrak untuk gambar, video, audio, dan dokumen, serta berarti CDN Anda tetap menjadi sumber asli konten Anda sendiri.
Baca selanjutnya
Autentikasi
Kunci, cakupan, dan lingkungan
Konvensi
ID, cap waktu, error, percobaan ulang
Dapatkan input suatu alur kerja
Kontrak input yang menjadi acuan pengumpulan
Mengirim file melalui URL
Aturan tautan yang kami tegakkan
Mulai run alur kerja
Memulai pekerjaan
Baca workflow run
Status dan aset
Webhook
Diberi tahu alih-alih bertanya
Kesalahan & batas
Setiap kode error dan setiap batas