MarkkinatSelaaKokeile
Hinnoittelu
Kirjaudu sisäänAloita
Kehittäjille

MCP ja tekoälyavustajat

Gradientlyssä on HTTP-API ja ylläpidetty MCP-palvelin. Yhdistä avustaja OAuthilla tai työtilaan rajatulla API-avaimella.

Päivitetty 11. lokakuuta 2026

Kehittäjädokumentaatio

  • Yleiskatsaus
  • MCP ja tekoälyavustajat
  • API-referenssi
  • API-avaimet ja oikeudet

Tällä sivulla

Ennen kuin yhdistätYhdistä ChatGPT ja ClaudeYhdistä Claude CodeMuut asiakasohjelmatMiten työkalut toimivatMarkitBrändit ja työtilaSuunnitteluMuokkaaminen ja vientiVideo, ääni ja tekstityksetEsimerkkikehotteita

Palvelin hyväksyy OAuth-käyttötokenit ja työtilan API-avaimet. Molempiin sovelletaan samoja oikeuksia, lisenssejä, krediittejä ja rajoja. Model Context Protocol on avoin standardi, jolla tekoälyavustajille annetaan työkaluja. Gradientlyllä on isännöity MCP-palvelin. ChatGPT yhdistää osoitteeseen https://gradiently.design/api/mcp/chatgpt, Claude ja muut asiakasohjelmat osoitteeseen https://gradiently.design/api/mcp. Yhdistä se kerran API-avaimella, niin avustajasi voi kutsua Gradientlyn työkaluja, kun keskustelet sen kanssa. Jokainen työkalu tekee samat API-pyynnöt kuin oma koodisi tekisi, joten sillä on samat oikeudet, lisenssit, krediitit ja rajat.

Ennen kuin yhdistät

  • Luo avain kohdassa Asetukset › API ja agentit (katso API-avaimet ja oikeudet). Avain ratkaisee, missä työtilassa avustaja toimii ja mitkä työkalut toimivat.
  • API-avainasiakas lähettää otsakkeen Authorization: Bearer gr_live_…. ChatGPT ja Claude lähettävät OAuth-tokenin kirjautumisen jälkeen.
  • Palvelin käyttää Streamable HTTP -yhteyttä tilattomasti JSON-vastauksin. Se ei tarvitse istuntoa, eikä erillistä tapahtumavirtaa tarvitse avata.
  • Palvelin hyväksyy OAuth-käyttötokenit ja työtilan API-avaimet. Molempiin sovelletaan samoja oikeuksia, lisenssejä, krediittejä ja rajoja.

Yhdistä ChatGPT ja Claude

Lisää mukautettu yhteys osoitteella ChatGPT: https://gradiently.design/api/mcp/chatgpt; Claude: https://gradiently.design/api/mcp ja valitse OAuth-kirjautuminen. Kirjaudu Gradientlyyn, valitse työtila ja tarkista oikeudet. Vain omistajat ja ylläpitäjät voivat yhdistää avustajan.

Yhteydet vanhenevat tunnin kuluttua ja uusiutuvat automaattisesti enintään 30 päivän ajan. Peru yhteys kohdassa Asetukset › API ja agentit, niin käyttö ja uusiminen päättyvät heti.

Mukautettu yhteys ja julkisen hakemiston listaus ovat eri asioita. Hakemistossa julkaiseminen vaatii OpenAI:n tai Anthropicin tarkistuksen ja hyväksynnän.

Yhdistä Claude Code

Lisää Gradiently etäpalvelimeksi HTTP:n yli niin, että avaimesi on otsakkeessa. Pidä avain ympäristömuuttujassa, jotta se ei koskaan päädy komentohistoriaasi tai versionhallintaan tallennettuun tiedostoon.

bash
# Paste your key when asked. It stays hidden and out of your shell history.
read -rs GRADIENTLY_API_KEY && export GRADIENTLY_API_KEY

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

Aloita uusi Claude Code -istunto ja pyydä sitä listaamaan Gradientlyn työkalut, niin näet, toimiiko yhteys. Jos se ilmoittaa tunnistautumisvirheestä, avain on kirjoitettu väärin tai kumottu, tai sen luoja ei ole enää työtilan omistaja tai ylläpitäjä.

Muut asiakasohjelmat

Mikä tahansa asiakasohjelma, joka voi lisätä etä-MCP-palvelimen Streamable HTTP:n yli ja lähettää mukautetun pyyntöotsakkeen, voi käyttää Gradientlyä samalla URL-osoitteella ja otsakkeella. Se, onnistuuko tämä omalla ohjelmallasi, riippuu ohjelmasta ja sen versiosta.

  • JSON-tiedostolla määritettävät asiakasohjelmat hyväksyvät usein alla olevan muodon, joka näkyy myös Asetuksissa kohdassa Yhdistä MCP-asiakasohjelma. Tarkista ohjelmasi dokumentaatiosta sen tarkka muoto.
json
{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer gr_live_…" }
    }
  }
}

Salli pitkät työkalukutsut

Useimmat työkalut vastaavat sekunneissa. render_design, inspect_design ja export_mark voivat kestää jopa kolme minuuttia, design noin viisi ja create_designs yhdessä wait-asetuksen kanssa noin neljä. Jos asiakasohjelmassasi on työkalujen aikakatkaisuasetus, nosta sitä vastaavasti.

Miten työkalut toimivat

  • Työkalut palauttavat JSON-tekstiä. inspect_design palauttaa myös PNG-kuvan. Virhetilanteessa palautetaan virheilmoitus.
  • Brändiä tarvitsevat työkalut ottavat valinnaisen personality-arvon (sen id:n tai slugin). Ilman sitä ne käyttävät työtilan ensimmäistä brändiä.
  • Designin tallentavat työkalut palauttavat sen Studio-linkin eli designin osoitteen /studio/<id> sivustolla gradiently.design.
  • Monet työkalut hakevat ensin brändisi osoitteesta /api/me, joka vaatii sekä oikeuden workspaces:read että designs:read. Näiden työkalujen kohdalla alla luetellaan molemmat oikeudet.
  • Työkalukutsu kuluttaa avaimesi pyyntörajaa kerran MCP-pyynnöstä ja kerran jokaisesta työkalun tekemästä API-pyynnöstä.

Oikeudet, jotka annat avustajalle

Asetuksissa tehdyllä avaimella on valmiina designs:read, designs:write, marks:read, brand:generate ja workspaces:read: ne riittävät jokaiseen suunnittelutyökaluun. Lisää marks:claim Markien lunastamiseen, personalities:write brändien luomiseen tai niiden Markin ja profiilin muuttamiseen ja members:write kutsujen lähettämiseen.

Markit

search_marks

Mitä se tekee

Hakee julkisilta Markkinoilta nimellä tai koodilla. Palauttaa värit, materiaalit, tilan ja haltijan.

Syötteet

q, tone (dark tai light), limit (vähintään 1, enintään 120, oletus 24), kaikki valinnaisia

Oikeudet

marks:read
get_mark

Mitä se tekee

Yksi Mark ja sen koko resepti.

Syötteet

code (koodi tai id)

Oikeudet

marks:read
list_marks

Mitä se tekee

Tämän työtilan hallussa olevat Markit lisenssin tiloineen sekä luonnoksesi siinä.

Syötteet

ei mitään

Oikeudet

marks:read
claim_mark

Mitä se tekee

Lunastaa vapaan Markin. Sen haltija on avaimen luoja, ei koskaan työtila.

Syötteet

code

Oikeudet

marks:read, marks:claim
export_mark

Mitä se tekee

Renderöi Markin sellaisenaan PNG-kuvaksi, jonka sivu on enintään 4096 px.

Syötteet

mark, width, height, personality

Oikeudet

workspaces:read, designs:read, designs:write
restore_mark_version

Mitä se tekee

Palauttaa version luonnokseksi. Nykyinen tila tallennetaan ensin versioksi.

Syötteet

mark, version

Oikeudet

brand:generate
update_mark_version

Mitä se tekee

Nimeää version uudelleen tai merkitsee sen tähdellä. Tähdellä merkityt versiot säilytetään.

Syötteet

mark, version, label, starred

Oikeudet

brand:generate
delete_mark_version

Mitä se tekee

Poistaa version, mutta ei koskaan julkaistua.

Syötteet

mark, version

Oikeudet

brand:generate
TyökaluMitä se tekeeSyötteetOikeudet
search_marksHakee julkisilta Markkinoilta nimellä tai koodilla. Palauttaa värit, materiaalit, tilan ja haltijan.q, tone (dark tai light), limit (vähintään 1, enintään 120, oletus 24), kaikki valinnaisiamarks:read
get_markYksi Mark ja sen koko resepti.code (koodi tai id)marks:read
list_marksTämän työtilan hallussa olevat Markit lisenssin tiloineen sekä luonnoksesi siinä.ei mitäänmarks:read
claim_markLunastaa vapaan Markin. Sen haltija on avaimen luoja, ei koskaan työtila.codemarks:read, marks:claim
export_markRenderöi Markin sellaisenaan PNG-kuvaksi, jonka sivu on enintään 4096 px.mark, width, height, personalityworkspaces:read, designs:read, designs:write
restore_mark_versionPalauttaa version luonnokseksi. Nykyinen tila tallennetaan ensin versioksi.mark, versionbrand:generate
update_mark_versionNimeää version uudelleen tai merkitsee sen tähdellä. Tähdellä merkityt versiot säilytetään.mark, version, label, starredbrand:generate
delete_mark_versionPoistaa version, mutta ei koskaan julkaistua.mark, versionbrand:generate

Maksua vaativa lunastus epäonnistuu viestillä, jonka mukaan se vaatii kassan; viimeistele se Gradientlyssä. Avain ei voi maksaa mitään.

Brändit ja työtila

list_personalities

Mitä se tekee

Työtilan brändit id:ineen.

Syötteet

ei mitään

Oikeudet

workspaces:read, designs:read
create_personality

Mitä se tekee

Luo nimetyn brändin.

Syötteet

name

Oikeudet

personalities:write
get_brand_profile

Mitä se tekee

Mikä brändi on, kenelle se on tarkoitettu, sen äänensävy, tehtävät ja vältettävät asiat sekä fontit.

Syötteet

personality

Oikeudet

workspaces:read, designs:read
update_brand_profile

Mitä se tekee

Korvaa brändin profiilin. Designer lukee sen ennen jokaista designia.

Syötteet

personality, profile

Oikeudet

workspaces:read, designs:read, personalities:write
my_workspace

Mitä se tekee

Sinä, työtilan brändit Markkiensa koodeineen ja työtilan hallussa olevat Markit.

Syötteet

ei mitään

Oikeudet

workspaces:read, designs:read, marks:read
list_workspaces

Mitä se tekee

Avaimen työtila ja roolisi siinä.

Syötteet

cursor

Oikeudet

workspaces:read
invite_member

Mitä se tekee

Lähettää sähköpostitse seitsemän päivää voimassa olevan kutsun liittyä työtilaan.

Syötteet

workspaceId, email, role (admin, editor tai viewer)

Oikeudet

members:write
TyökaluMitä se tekeeSyötteetOikeudet
list_personalitiesTyötilan brändit id:ineen.ei mitäänworkspaces:read, designs:read
create_personalityLuo nimetyn brändin.namepersonalities:write
get_brand_profileMikä brändi on, kenelle se on tarkoitettu, sen äänensävy, tehtävät ja vältettävät asiat sekä fontit.personalityworkspaces:read, designs:read
update_brand_profileKorvaa brändin profiilin. Designer lukee sen ennen jokaista designia.personality, profileworkspaces:read, designs:read, personalities:write
my_workspaceSinä, työtilan brändit Markkiensa koodeineen ja työtilan hallussa olevat Markit.ei mitäänworkspaces:read, designs:read, marks:read
list_workspacesAvaimen työtila ja roolisi siinä.cursorworkspaces:read
invite_memberLähettää sähköpostitse seitsemän päivää voimassa olevan kutsun liittyä työtilaan.workspaceId, email, role (admin, editor tai viewer)members:write

tone hyväksyy enintään kolme arvoista calm, bold, warm, cool, playful, luxe, natural, technical, editorial ja nocturnal; pyyntö, jossa niitä on enemmän, hylätään. colours hyväksyy enintään kahdeksan hex-väriä, ja count pyytää yhdestä kahdeksaan ehdotusta; myös näiden rajojen ylittävä pyyntö hylätään. Kun otat ehdotuksen käyttöön, lähetä täsmälleen sama syöte, josta se luotiin, ja ehdotuksen key: palvelin tekee ehdotuksen uudelleen tuosta syötteestä eikä koskaan luota asiakasohjelman lähettämään reseptiin.

Suunnittelu

Pyydä yhdistettyä tekoälyäsi lukemaan brändiprofiili ja get_design_guidance, luomaan design draw_design-työkalulla, tarkastamaan oikea kuva inspect_design-työkalulla ja viimeistelemään se edit_design-työkalulla. Suora piirtäminen, muokkaaminen ja tarkastaminen eivät käytä Gradientlyn tekoälykrediittejä. Palveluntarjoajasi käyttörajat sekä tilin ja viennin käyttöoikeudet ovat edelleen voimassa. Piirros voi sisältää isäntämallin omaa vektorikuvitusta, puhdistettua SVG:tä, aitoja kaavioita, kirjaston grafiikkaa ja lisensoituja valokuvia; kaikki pysyy muokattavana Studiossa. Valokuvahaku ja -tuonti käyttävät Openverseä, ulkoista luetteloa.

get_design_guidance

Mitä se tekee

Tarkistettua kirjallista taiteellista ohjausta: laatutaso, piirtämisen mahdollisuudet, konseptimenetelmä ja arviointikierros sekä syvemmät aiheet, kuten kuvitus, data ja typografia. Ei malleja eikä mallin koulutusta.

Syötteet

purpose, topic

Oikeudet

mikä tahansa avain
draw_design

Mitä se tekee

Piirtää alkuperäisen, muokattavan designin yhdistetyllä tekoälylläsi: tekstiä, muotoja, omaa vektorikuvitusta, SVG:tä, aitoja kaavioita, grafiikkaa, valokuvia, Mark-ikkunoita ja taulukoita. Vain valittu sivu piirretään uudelleen.

Syötteet

drawing, personality, mark, designId, page, title

Oikeudet

designs:write, workspaces:read, designs:read, marks:read
inspect_design

Mitä se tekee

Palauttaa aidon PNG-kuvan, jonka avustaja voi tarkastaa ja viimeistellä. Pienemmät koot ovat koko sivu pienennettynä, kuten syöte sen näyttää.

Syötteet

id, page, maxDimension

Oikeudet

designs:read
find_icons

Mitä se tekee

Etsii sisäänrakennettujen kuvakkeiden kelvollisia nimiä.

Syötteet

query, limit

Oikeudet

mikä tahansa avain
find_graphics

Mitä se tekee

Etsii Gradientlyn omaa, uudelleen väritettävää grafiikkaa tukeviksi yksityiskohdiksi.

Syötteet

query, limit

Oikeudet

mikä tahansa avain
find_photos

Mitä se tekee

Hakee lisensoituja valokuvia Openversestä ja palauttaa pikkukuvat, joita avustaja voi katsoa. Kertoo, jos pikkukuvaa ei saada. Mitään ei tallenneta.

Syötteet

query, count

Oikeudet

designs:read
import_photo

Mitä se tekee

Kopioi valitun valokuvan työtilan latauksiin tekijätietoineen latauskiintiösi rajoissa.

Syötteet

id

Oikeudet

designs:write
designPyytää Gradientlyn omaa Designeria tekemään designin tai muuttamaan sitä tavallisen pyynnön perusteella. Se lukee brändin profiilin ja Markin, suunnittelee, arvioi ja tallentaa. Käyttää Gradientlyn tekoälykrediittejä.

Syötteet

request, personality, size, designId, scope, selection

Oikeudet

workspaces:read, designs:read, designs:write
create_designs

Mitä se tekee

Tekee taustalla enintään kahdentoista designin sarjan yhdestä briefistä. Käyttää Gradientlyn tekoälykrediittejä.

Syötteet

brief, items (size, brief, title), title, personality, mark, wait

Oikeudet

workspaces:read, designs:read, designs:write
get_design_set

Mitä se tekee

Sarjan edistyminen ja kunkin designin Studio-linkki, kun design on olemassa.

Syötteet

id

Oikeudet

designs:read
stop_design_set

Mitä se tekee

Pysäyttää käynnissä olevan sarjan. Jo piirretyt designit pysyvät tallessa.

Syötteet

id

Oikeudet

designs:write
compose_design

Mitä se tekee

Asettelee tekstisi asettelumoottorilla ja tallentaa sen. Palauttaa korjattavat arviointihuomiot.

Syötteet

composition, personality, designId, title

Oikeudet

workspaces:read, designs:read, designs:write
list_sizes

Mitä se tekee

Kaikki kokoesiasetukset pikselikokoineen.

Syötteet

ei mitään

Oikeudet

mikä tahansa avain
create_design

Mitä se tekee

Luo designin pohjamuodosta (oletuksena tyhjä), kokoesiasetuksesta ja elementtien id:iden mukaan annetusta tekstistä.

Syötteet

form, size, copy, look, personality

Oikeudet

workspaces:read, designs:read, designs:write
TyökaluMitä se tekeeSyötteetOikeudet
get_design_guidanceTarkistettua kirjallista taiteellista ohjausta: laatutaso, piirtämisen mahdollisuudet, konseptimenetelmä ja arviointikierros sekä syvemmät aiheet, kuten kuvitus, data ja typografia. Ei malleja eikä mallin koulutusta.purpose, topicmikä tahansa avain
draw_designPiirtää alkuperäisen, muokattavan designin yhdistetyllä tekoälylläsi: tekstiä, muotoja, omaa vektorikuvitusta, SVG:tä, aitoja kaavioita, grafiikkaa, valokuvia, Mark-ikkunoita ja taulukoita. Vain valittu sivu piirretään uudelleen.drawing, personality, mark, designId, page, titledesigns:write, workspaces:read, designs:read, marks:read
inspect_designPalauttaa aidon PNG-kuvan, jonka avustaja voi tarkastaa ja viimeistellä. Pienemmät koot ovat koko sivu pienennettynä, kuten syöte sen näyttää.id, page, maxDimensiondesigns:read
find_iconsEtsii sisäänrakennettujen kuvakkeiden kelvollisia nimiä.query, limitmikä tahansa avain
find_graphicsEtsii Gradientlyn omaa, uudelleen väritettävää grafiikkaa tukeviksi yksityiskohdiksi.query, limitmikä tahansa avain
find_photosHakee lisensoituja valokuvia Openversestä ja palauttaa pikkukuvat, joita avustaja voi katsoa. Kertoo, jos pikkukuvaa ei saada. Mitään ei tallenneta.query, countdesigns:read
import_photoKopioi valitun valokuvan työtilan latauksiin tekijätietoineen latauskiintiösi rajoissa.iddesigns:write
designPyytää Gradientlyn omaa Designeria tekemään designin tai muuttamaan sitä tavallisen pyynnön perusteella. Se lukee brändin profiilin ja Markin, suunnittelee, arvioi ja tallentaa. Käyttää Gradientlyn tekoälykrediittejä.request, personality, size, designId, scope, selectionworkspaces:read, designs:read, designs:write
create_designsTekee taustalla enintään kahdentoista designin sarjan yhdestä briefistä. Käyttää Gradientlyn tekoälykrediittejä.brief, items (size, brief, title), title, personality, mark, waitworkspaces:read, designs:read, designs:write
get_design_setSarjan edistyminen ja kunkin designin Studio-linkki, kun design on olemassa.iddesigns:read
stop_design_setPysäyttää käynnissä olevan sarjan. Jo piirretyt designit pysyvät tallessa.iddesigns:write
compose_designAsettelee tekstisi asettelumoottorilla ja tallentaa sen. Palauttaa korjattavat arviointihuomiot.composition, personality, designId, titleworkspaces:read, designs:read, designs:write
list_sizesKaikki kokoesiasetukset pikselikokoineen.ei mitäänmikä tahansa avain
create_designLuo designin pohjamuodosta (oletuksena tyhjä), kokoesiasetuksesta ja elementtien id:iden mukaan annetusta tekstistä.form, size, copy, look, personalityworkspaces:read, designs:read, designs:write

design ja create_designs kuluttavat työtilan AI-krediittejä samoin kuin Designer Studiossa. Kun saldo on liian pieni, ne epäonnistuvat viestillä, joka kertoo siitä; lisää krediittejä kohdassa Asetukset › AI-krediitit. Kullakin henkilöllä voi olla käynnissä enintään kaksi sarjaa kerrallaan, ja valmis sarja on luettavissa noin kaksikymmentä minuuttia. Itse designit säilyvät.

Sommitelma nimeää koon size (esiasetuksen id, kuten ig-post, x-post tai li-banner, tai {w, h} pikseleinä), asettelun layout (statement, editorial, poster, split, stat, quote, list, event tai minimal) ja lukujärjestyksessä olevat lohkot blocks, joilla kullakin on role, kuten headline, body tai cta, sekä sen text.

json
{
  "composition": {
    "size": "ig-post",
    "layout": "event",
    "blocks": [
      { "role": "eyebrow", "text": "Summer supper club" },
      { "role": "headline", "text": "Long table on the roof" },
      { "role": "details", "text": "", "items": ["Saturday 21 June", "7pm till late"] },
      { "role": "cta", "text": "Book a seat" }
    ]
  }
}
Syöte työkalulle compose_design. Vastauksessa ovat designin id, sen Studio-linkki, arviointihuomiot ja sen sijoittamat elementit.

Muokkaaminen ja vienti

list_designs

Mitä se tekee

Brändin tallennetut designit Studio-linkkeineen.

Syötteet

personality

Oikeudet

workspaces:read, designs:read
get_design

Mitä se tekee

Designin koko, sivut ja jokainen elementti ominaisuuksineen. Suodata pitkiä designeja sivun, lajin, nimen tai tekstin mukaan.

Syötteet

id, page, kind, name, text

Oikeudet

designs:read
edit_design

Mitä se tekee

Muuttaa designia enintään 100 toiminnolla, kuten ihminen tekisi Studiossa, ja tallentaa sen.

Syötteet

id, ops, page

Oikeudet

designs:write
update_design_text

Mitä se tekee

Korvaa valittujen tekstielementtien sanat ja säilyttää asettelun.

Syötteet

id, text (elementin id ja sen sanat)

Oikeudet

designs:read, designs:write
resize_copies

Mitä se tekee

Tallentaa kopiot enintään kahdeksaan muuhun kokoon ja asettelee ne uudelleen Studion tapaan. Alkuperäinen ei muutu.

Syötteet

id, sizes

Oikeudet

designs:read, designs:write
wear_mark

Mitä se tekee

Vaihtaa Markin yhteen designiin tai tekee siitä brändin Markin uusille designeille.

Syötteet

mark sekä design tai personality

Oikeudet

katso alta
render_design

Mitä se tekee

Renderöi tallennetun designin PNG- tai PDF-tiedostoksi Studion moottorilla. Palauttaa tiedoston base64-muodossa.

Syötteet

id, width, height, format, page

Oikeudet

designs:read
export_design_link

Mitä se tekee

Julkaisee katselulinkin /d/<id>, jonka kuka tahansa linkin saanut voi avata.

Syötteet

id

Oikeudet

designs:write
TyökaluMitä se tekeeSyötteetOikeudet
list_designsBrändin tallennetut designit Studio-linkkeineen.personalityworkspaces:read, designs:read
get_designDesignin koko, sivut ja jokainen elementti ominaisuuksineen. Suodata pitkiä designeja sivun, lajin, nimen tai tekstin mukaan.id, page, kind, name, textdesigns:read
edit_designMuuttaa designia enintään 100 toiminnolla, kuten ihminen tekisi Studiossa, ja tallentaa sen.id, ops, pagedesigns:write
update_design_textKorvaa valittujen tekstielementtien sanat ja säilyttää asettelun.id, text (elementin id ja sen sanat)designs:read, designs:write
resize_copiesTallentaa kopiot enintään kahdeksaan muuhun kokoon ja asettelee ne uudelleen Studion tapaan. Alkuperäinen ei muutu.id, sizesdesigns:read, designs:write
wear_markVaihtaa Markin yhteen designiin tai tekee siitä brändin Markin uusille designeille.mark sekä design tai personalitykatso alta
render_designRenderöi tallennetun designin PNG- tai PDF-tiedostoksi Studion moottorilla. Palauttaa tiedoston base64-muodossa.id, width, height, format, pagedesigns:read
export_design_linkJulkaisee katselulinkin /d/<id>, jonka kuka tahansa linkin saanut voi avata.iddesigns:write

wear_mark designille vaatii oikeudet designs:read ja designs:write. Markin tekeminen brändin Markiksi vaatii oikeudet workspaces:read, designs:read ja personalities:write sekä Markin, joka on hallussasi voimassa olevalla lisenssillä. Jos nimeät Markin sen koodilla, tarvitaan myös marks:read.

render_design ottaa arvot width ja height 1:n ja 4096 pikselin väliltä sekä format-arvon png tai pdf. page lasketaan nollasta: PNG renderöi oletuksena ensimmäisen sivun ja PDF kaikki sivut. PDF säilyttää jokaisen sivun Studion koossa, joten pyytämäsi koon on vastattava sitä. Renderöinti vaatii designin Markille saman vientilisenssin kuin Studio, eikä se koskaan julkaise tai muuta designia.

Video, ääni ja tekstitykset

Etsi sallitut lähdeviittaukset työkalulla find_uploads ja käytä sitten edit_design-työkalua komennoilla add_video, update_video, split_video, add_audio, update_audio, split_audio, remove_audio, set_element_timing, set_captions tai remove_captions. Älä koskaan arvaa lähteen kestoa. Videon jakaminen ja elementtien ajoitus käyttävät sivun sekunteja; äänen aloitukset, äänen jakaminen ja tekstitykset käyttävät koko dokumentin sekunteja. Ääni ei pidennä kohtauksia. Tekstitykset hyväksyvät annetun tekstin aikoineen tai SRT/WebVTT-sisällön; automaattista litterointia ei ole saatavilla. get_design palauttaa koko aikajanan ja raidat. export_captions palauttaa SRT/WebVTT-tiedoston sisällön enintään 100 tekstityksen ja 48 000 merkin osissa; hae seuraava osa arvolla nextOffset.

Esimerkkikehotteita

  • ”Etsi Markkinoilta tummia Markeja, joissa on kromia, ja näytä kolme lähimpänä syvää sinivihreää olevaa.” Käyttää työkalua search_marks.
  • ”Vaihda designin 4f1c… otsikoksi ’Ovet aukeavat seitsemältä’ ja tee kopiot Instagram-tarinaa ja X-julkaisua varten.” Käyttää työkaluja get_design, update_design_text ja resize_copies.
  • ”Renderöi design 4f1c… 1080 × 1350 -kokoiseksi PNG-kuvaksi ja tallenna se tiedostoon launch.png.” Käyttää työkalua render_design.
  • ”Tee juliste kattoterassin juhannusjuhliimme 21. kesäkuuta, auringonlaskusta auringonnousuun.” Käyttää työkalua design, joka vaatii oikeuden workspaces:read.

Näiden työkalujen taustalla olevien päätepisteiden koko referenssi on sivulla API-referenssi. Kaikessa muussa lähetä meille pyyntö.

Tarvitsetko apua?

Lähetä meille pyyntö aiheella API ja MCP, niin ihminen vastaa.

Lähetä pyyntö

Löydä ilme, joka on vain sinun.

Jokainen Mark on elävä tausta, jolla on yksi omistaja. Kokeile vapaata Markia ja lunasta omasi, kun se tuntuu oikealta.

Aloita suunnitteluKatso julkaisutarjous

Lunastettavia Markeja jäljellä

50/ 1 000

950 lunastettu tähän mennessäLöydä omasi

Tarkista sertifikaatti

Kirjoita sertifikaatin numero tai Markin koodi nähdäksesi, kuka sen omistaa.

Toimii ChatGPT:n ja Clauden kanssa

Pyydä tekoälyltäsi designia. Se tekee sen Markissasi, muokkausvalmiina.

ChatGPTClaude
Näin yhdistät

Tuote

  • Markkinat
  • Selaa
  • Hinnoittelu
  • Julkaisupaketit
  • Sertifikaatit

Opi

  • Suunnitteluopas
  • Ohjekeskus
  • Mitä uutta

Kehittäjille

  • Yleiskatsaus
  • ChatGPT ja Claude
  • API-viite
  • API-avaimet

Yritys

  • Tietoa meistä
  • Ota yhteyttä
  • Kirjaudu sisään

Juridiikka

  • Ehdot
  • Tietosuoja
  • Hyvitykset
  • Markin suoja
  • Evästeet
  • Kaikki käytännöt
Liiku kirjainten yli. Jokaisessa on oikea Mark.Kosketa kirjainta nähdäksesi sen Markin.Yksi nimi. Kymmenen Markia sen sisällä.
© 2026 Gradiently