> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/deka-gpu-documentations/panduan-untuk-enterprise/deka-llm/detail-deka-llm/playground/integrasi-api-preview.md).

# Integrasi API Preview

*API Integration Preview* adalah fitur pada *Service Portal Cloudeka* yang menampilkan cuplikan kode yang dibuat otomatis untuk setiap *prompt* yang Anda kirimkan ke model melalui panel *Interactive Chat*. Setiap kali menguji *prompt* pada tab *Playground*, Deka LLM akan membuat contoh panggilan API yang siap digunakan secara otomatis.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-17d160255fedba26c03e1b253da20ef62fc48f37%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

## *cURL*

**cURL (*****Client URL*****)** adalah alat baris perintah untuk mengirim permintaan ke server melalui berbagai protokol, seperti HTTP, HTTPS, dan FTP. Berikut contoh perintah `cURL` yang dibuat saat Anda memasukkan *prompt*.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-4019818da2258f7a5f56429a6f1abd76c476c828%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% code lineNumbers="true" %}

```url
curl https://dekallm.cloudeka.ai/v1/chat/completions \
  -H "Authorization": "Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "meta/llama-4-maverick-instruct",
    "messages": [{"role": "user", "content": ""}],
    "temperature": 0.6,
    "top_p": 0.7
  }'
```

{% endcode %}

Penjelasan perintah *cURL*.

```
curl https://dekallm.cloudeka.ai/v1/chat/completions \
```

Baris `curl https://dekallm.cloudeka.ai/v1/chat/completions \` menentukan URL *endpoint* API yang digunakan Deka LLM untuk meminta penyelesaian percakapan.

```
  -H "Authorization": "Bearer YOUR_API_KEY" \
```

{% hint style="success" %}
Baris ini sesuai dengan *API Key* yang Anda masukkan pada kolom *API Key*.
{% endhint %}

Baris `-H "Authorization": "Bearer YOUR_API_KEY" \` digunakan untuk mengautentikasi permintaan API dengan menyediakan kunci API dalam format token *Bearer*.

```
  -H "Content-Type: application/json" \
```

Baris `-H "Content-Type: application/json" \` menetapkan format *payload* permintaan ke JSON.

```
  -d '{
    "model": "meta/llama-4-maverick-instruct",
    "messages": [{"role": "user", "content": ""}],
    "temperature": 0.6,
    "top_p": 0.7
  }'

```

Objek JSON ini dikirim melalui permintaan HTTP *POST* dan berisi:

* **`"model": "meta/llama-4-maverick-instruct",`**

  Menentukan model *LLM* yang digunakan pada Deka LLM.
* **`"messages": [{"role": "user", "content": ""}],`**

  Array pesan, dengan `"role": "user"` mewakili Anda dan `"content": ""` adalah *prompt*.
* **`temperature": 0.6`**

  Mengatur kreativitas atau tingkat keacakan respons. Nilai lebih tinggi menghasilkan respons lebih kreatif.
* **`"top_p": 0.7`**

  Mengonfigurasi *nucleus sampling* untuk mengatur probabilitas kumulatif pemilihan token dan tingkat keacakan.

## *Python*

**Python** adalah bahasa pemrograman yang dikenal dengan sintaks sederhana, mudah dibaca, serta dukungan terhadap paradigma imperatif, fungsional, dan berorientasi objek. Berikut contoh kode yang dibuat otomatis saat Anda memasukkan *prompt*.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-7fcb88ed35ff94839656951b9ca320c08c759caa%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

{% code lineNumbers="true" %}

```
from openai import OpenAI

client = OpenAI(
    base_url="https://dekallm.cloudeka.ai/v1",
    api_key="YOUR_API_KEY",
)

completion = client.chat.completions.create(
    model="baai/bge-multilingual-gemma2",
    messages=[{"role": "user", "content": ""}],
    temperature=0.6,
    top_p=0.7,
)
print(completion.choices[0].message.content)
```

{% endcode %}

Penjelasan kode *Python*:

```
from openai import OpenAI
```

Mengimpor kelas `OpenAI` dari SDK *Python OpenAI* resmi, yang menyediakan antarmuka untuk berinteraksi dengan API *LLM*.

```
client = OpenAI(
    base_url="https://dekallm.cloudeka.ai/v1",
    api_key="YOUR_API_KEY",
)
```

Baris ini digunakan untuk membuat instans klien yang berkomunikasi dengan *endpoint* API Deka LLM. Terdapat dua parameter penting:

* `base_url` menampilkan URL *endpoint* Deka LLM.
* `api_key` digunakan untuk mengautentikasi permintaan dan diambil dari kolom *API Key*.

```
completion = client.chat.completions.create(
    model="meta/llama-4-maverick-instruct",
    messages=[{"role": "user", "content": ""}],
    temperature=0.6,
    top_p=0.7,
)
```

Baris `client.chat.completions.create()` digunakan untuk mengirim permintaan penyelesaian percakapan. Terdapat empat parameter penting:

* `model="meta/llama-4-maverick-instruct",`

  Menentukan model *LLM* yang digunakan pada Deka LLM.
* `messages=[{"role": "user", "content": ""}],`

  Array pesan, dengan `"role": "user"` mewakili Anda dan `"content": ""` adalah *prompt*.
* `temperatur=0.6`

  Mengatur kreativitas atau tingkat keacakan respons. Nilai lebih tinggi menghasilkan respons lebih kreatif.
* `top_p=0.7`

  Mengonfigurasi *nucleus sampling* untuk mengatur probabilitas kumulatif pemilihan token dan tingkat keacakan.

```
print(completion.choices[0].message.content)
```

Baris `print(completion.choices[0].message.content)` digunakan untuk menampilkan respons model terhadap pesan yang Anda kirim.

## *Node.js*

**Node.js** adalah lingkungan *runtime* untuk menjalankan kode *JavaScript* di luar peramban. Berikut contoh kode *Node.js* yang dibuat saat Anda memasukkan *prompt*.

<figure><img src="https://753761090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAYQyBIz2BclZ3ZHHlS4%2Fuploads%2Fgit-blob-8835df086afaedf7da2552b0f22b6dbd6767126f%2Funknown.png?alt=media" alt=""><figcaption></figcaption></figure>

```
import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://dekallm.cloudeka.ai/v1",
});

const chatCompletion = await openai.chat.completions.create({
  model: "baai/bge-multilingual-gemma2",
  messages: [{ role: "user", content: "" }],
  temperature: 0.6,
  top_p: 0.7,
});
```

Penjelasan kode *Node.js*:

```
import OpenAI from "openai";
```

Baris `import OpenAI from "openai";` mengimpor kelas *OpenAI* dari SDK *Node.js* resmi, yang memungkinkan Anda berinteraksi dengan API Deka LLM.

```
const openai = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://dekallm.cloudeka.ai/v1",
});
```

Baris `const openai = new OpenAI({...});` digunakan untuk membuat instans dengan konfigurasi `apiKey` dan `baseURL`.

```
const chatCompletion = await openai.chat.completions.create({
  model: "baai/bge-multilingual-gemma2",
  messages: [{ role: "user", content: "" }],
  temperature: 0.6,
  top_p: 0.7,
});
```

Baris `const chatCompletion = await openai.chat.completions.create({...});` digunakan untuk mengirim permintaan penyelesaian percakapan ke model yang Anda gunakan pada Deka LLM. Terdapat empat parameter penting:

* `model="meta/llama-4-maverick-instruct",`

  Menentukan model *LLM* yang digunakan pada Deka LLM.
* `messages=[{"role": "user", "content": ""}],`

  Array pesan, dengan `"role": "user"` mewakili Anda dan `"content": ""` adalah *prompt*.
* `temperatur=0.6`

  Mengatur kreativitas atau tingkat keacakan respons. Nilai lebih tinggi menghasilkan respons lebih kreatif.
* `top_p=0.7`

  Mengonfigurasi *nucleus sampling* untuk mengatur probabilitas kumulatif pemilihan token dan tingkat keacakan.