> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BuildShip'i CometAPI'ye bağlayın

> Base URL, API key ve model veya provider seçeneklerini ayarlayarak BuildShip'i CometAPI'ye bağlamak için bu kılavuzu kullanın.

BuildShip, low-code görsel bir backend oluşturucusudur. Herhangi bir iş akışına AI destekli metin üretimi eklemek için topluluk tarafından sunulan **CometAPI Text Generator** düğümünü kullanın.

## Ön koşullar

* Etkin bir API anahtarına sahip bir CometAPI hesabı — [buradan edinin](https://www.cometapi.com/console/token)
* Bir BuildShip hesabı — [buradan oturum açın](https://app.buildship.com)

<Steps>
  <Step title="CometAPI API anahtarınızı alın">
    [CometAPI konsolunda](https://www.cometapi.com/console/token) oturum açın. **Add API Key** seçeneğine tıklayın ve CometAPI API anahtarınızı kopyalayın.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Add API Key düğmesini gösteren CometAPI panosu" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Base URL ile CometAPI API anahtarı ayrıntıları" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="REST API tetikleyicisiyle bir workflow oluşturun">
    1. BuildShip panosunda **Create a new workflow → From Scratch** seçeneğine tıklayın.
    2. Canvas üzerinde **Add Trigger** seçeneğine tıklayın ve **REST API** seçin. Bu, workflow için çağrılabilir bir endpoint oluşturur.
  </Step>

  <Step title="CometAPI Text Generator düğümünü ekleyin">
    1. REST API tetikleyicisinin altında **+ Add a new step** seçeneğine tıklayın.
    2. Düğüm kitaplığı arama kutusuna `cometapi` yazın.
    3. **Community** listesinden **CometAPI Text Generator** seçeneğini seçin.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360694.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=4ac17cb84e36a7f026f618e2b5229bf2" alt="Arama sonuçlarında CometAPI Text Generator öğesini gösteren BuildShip düğüm kitaplığı" width="1915" height="960" data-path="images/integrations/810968_360694.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360712.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=5da7aa2a5bef0d8a9ce45eceace876d1" alt="Canvas'a eklenmiş CometAPI Text Generator düğümü" width="1786" height="930" data-path="images/integrations/810968_360712.png" />
    </Frame>
  </Step>

  <Step title="CometAPI entegrasyonunu bağlayın">
    Bu adım, düğüme hangi anahtar yönetim sistemini kullanacağını söyler.

    1. Sağ tarafta **Node Editor**'ı açmak için düğüme tıklayın.
    2. **Settings** sekmesine geçin.
    3. **Key-based Integration** bölümünde açılır menüyü açın ve **CometAPI** seçin.
    4. Sağ üst köşedeki mavi **Save** düğmesine tıklayın.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360713.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=ceea3b9fec0cf8a1ab81f70547b0a499" alt="Key-based Integration ayarı CometAPI olarak seçilmiş Node Editor Settings sekmesi" width="1895" height="923" data-path="images/integrations/810968_360713.png" />
    </Frame>
  </Step>

  <Step title="API anahtarınızı düğüme ekleyin">
    1. Node Editor'da **Inputs** sekmesine geçin (veya doğrudan düğüme tıklayın).
    2. Anahtar açılır menüsünü açmak için düğümün sağ üst köşesindeki 🔑 anahtar simgesine tıklayın.
    3. **+ Bring your own Key** seçeneğini seçin.
    4. Bir **Key ID** girin (ör. `cometapi-key-1`) ve CometAPI API anahtarınızı **Value** alanına yapıştırın.
    5. **Save** seçeneğine tıklayın.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360715.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=25c09a874e2a0ceadf2a83e1192323ca" alt="Key ID ve Value alanları doldurulmuş anahtar yönetimi iletişim penceresi" width="1710" height="920" data-path="images/integrations/810968_360715.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360714.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=7a946cdb3d110605b3a9f1d7d91e022b" alt="Anahtarın başarıyla bağlandığını gösteren düğüm" width="611" height="318" data-path="images/integrations/810968_360714.png" />
    </Frame>
  </Step>

  <Step title="Girdi parametrelerini yapılandırın">
    Düğümün **Inputs** sekmesinde:

    * **Instructions** (isteğe bağlı): bir sistem rolü ayarlayın, ör. `You are a productivity assistant.`
    * **Prompt**: **`</>`** simgesine tıklayın, ardından gelen istek gövdesini eşlemek için **Trigger → Body → prompt** seçin.
    * **Advanced → Model**: kullanmak istediğiniz geçerli model ID değerini girin.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360716.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=71431b9496c396bbe5fa8d529ca57b27" alt="Instructions, Prompt ve Model yapılandırılmış CometAPI düğümü" width="1895" height="940" data-path="images/integrations/810968_360716.png" />
    </Frame>
  </Step>

  <Step title="Bir Return Response düğümü ekleyin ve test edin">
    1. CometAPI düğümünün altında **+ Add a new step** seçeneğine tıklayın ve **Return Response** seçin.
    2. **Body** alanında **`</>`** seçeneğine tıklayın ve CometAPI Text Generator düğümünden `response` değişkenini seçin.
    3. Sağ üst köşedeki **Test** seçeneğine tıklayın, **JSON** giriş biçimini seçin ve şunu gönderin:

    ```json theme={null}
    {
      "prompt": "hi"
    }
    ```

    4. **Result** panelindeki başarılı bir yanıt, workflow'un çalıştığını doğrular.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360717.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=561ea8bcdfd96a014dab4476840ee377" alt="Başarılı bir CometAPI yanıtını gösteren BuildShip test paneli" width="1885" height="934" data-path="images/integrations/810968_360717.png" />
    </Frame>

    Çağrı başarısız olursa API anahtarınızı ve Key-based Integration ayarının **CometAPI** olarak seçildiğini doğrulayın ya da [CometAPI desteğiyle](https://www.cometapi.com) iletişime geçin.
  </Step>
</Steps>

<Tip>
  **Key-based Integration** adımı (düğümü CometAPI'ye bağlama) zorunludur — bu adımı atlamak, API anahtarınız doğru olsa bile kimlik doğrulama hatalarına neden olur.
</Tip>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/buildship#howto",
        "name": "BuildShip'i CometAPI'ye bağlayın",
        "description": "Base URL, API anahtarı ve model veya sağlayıcı seçeneklerini ayarlayarak BuildShip'i CometAPI'ye bağlamak için bu kılavuzu kullanın.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-1",
            "position": 1,
            "name": "CometAPI API anahtarınızı alın",
            "text": "CometAPI hesabınızı oluşturun veya açın, ardından panodan etkin bir API anahtarını kopyalayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-2",
            "position": 2,
            "name": "REST API tetikleyicisiyle bir workflow oluşturun",
            "text": "BuildShip'i CometAPI'ye bağlama kılavuzundaki REST API tetikleyicisiyle bir workflow oluşturun adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-3",
            "position": 3,
            "name": "CometAPI Text Generator düğümünü ekleyin",
            "text": "BuildShip'i CometAPI'ye bağlama kılavuzundaki CometAPI Text Generator düğümünü ekleyin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-4",
            "position": 4,
            "name": "CometAPI entegrasyonunu bağlayın",
            "text": "BuildShip'i CometAPI'ye bağlama kılavuzundaki CometAPI entegrasyonunu bağlayın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-5",
            "position": 5,
            "name": "API anahtarınızı düğüme ekleyin",
            "text": "BuildShip'i CometAPI'ye bağlama kılavuzundaki API anahtarınızı düğüme ekleyin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-6",
            "position": 6,
            "name": "Girdi parametrelerini yapılandırın",
            "text": "BuildShip'i CometAPI'ye bağlama kılavuzundaki Girdi parametrelerini yapılandırın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-7",
            "position": 7,
            "name": "Bir Return Response düğümü ekleyin ve test edin",
            "text": "BuildShip'i CometAPI'ye bağlama kılavuzundaki Bir Return Response düğümü ekleyin ve test edin adımını tamamlayın."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI Dokümantasyonu",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Entegrasyonlar",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "BuildShip'i CometAPI'ye bağlayın",
            "item": "https://apidoc.cometapi.com/integrations/buildship"
          }
        ]
      }
    ]
    }
    `}
</script>
