AI Text

Step AI Text mengirim prompt ke model AI untuk menghasilkan teks, seperti ringkasan, draft balasan, terjemahan, atau klasifikasi. Gunakan connection dengan akun provider kamu sendiri. Biaya diproses oleh provider sesuai model yang kamu gunakan.

Menghubungkan provider AI

Buka Connections → Add a connection dan pilih tab OpenAI-compatible. Jenis connection ini mendukung server dengan API yang kompatibel dengan OpenAI, seperti OpenRouter, Groq, Together, atau model yang kamu host.

Kolom	Catatan
Name	opsional
Base URL	OpenAI: https://api.openai.com/v1. OpenRouter: https://openrouter.ai/api/v1. Server harus dapat dijangkau melalui HTTPS dari internet; alamat lokal dan privat ditolak
Default model	model yang digunakan step AI Text kecuali step memilih yang lain, misalnya gpt-4o-mini di OpenAI atau openai/gpt-4o-mini di OpenRouter
Default image model	opsional; hanya untuk step AI Image, misalnya gpt-image-1
Default video model	opsional; hanya untuk step AI Video, misalnya google/veo-3.1 di OpenRouter
API key	key kamu untuk provider itu

Alur memvalidasi key melalui provider sebelum menyimpannya. Jika ditolak, kamu akan melihat alasannya dan perubahan tidak disimpan. Key disimpan terenkripsi dan tidak pernah ditampilkan lagi. Update key menggantinya tanpa mengubah referensi pada step, dan Disconnect menghapus connection; step AI Text yang masih menggunakannya gagal saat Run.

Menambah step AI Text

1. Di editor workflow, tekan +.
2. Pilih AI Text (di bawah AI). Salah satu connection AI kamu dipilih secara otomatis. Kamu dapat menggantinya melalui pengaturan step.
3. Isi kolom di bawah.

Setiap kolom menerima expression {{ <stepId>.<path> }}, seperti step lainnya.

Kolom	Catatan
Connection	wajib; provider yang dipanggil step ini
Prompt	wajib; yang kamu inginkan, biasanya dengan data dari step sebelumnya

Bagian Advanced dapat dibuka untuk mengatur opsi berikut:

Kolom	Catatan
Model	kosong menggunakan model default connection
System prompt	cara model harus berperilaku. Kosong berarti tidak dikirim
Temperature	0 sampai 2; nilai lebih rendah menghasilkan output yang lebih konsisten. Kosong menggunakan default provider
Max output tokens	membatasi panjang balasan. Kosong menggunakan 1024

Output dan kegagalan

Jika berhasil, output step berisi:

• text: balasan model, misalnya {{ step1.text }}
• model: model yang menjawab
• usage: promptTokens, completionTokens, dan totalTokens, bila dilaporkan provider

Permintaan yang ditolak (key salah, model tidak dikenal, saldo habis) atau response tanpa teks menggagalkan step dengan pesan dari provider, dan detail Run menampilkan pesan tersebut. Alur tidak mengulang kegagalan ini karena percobaan berikutnya dapat dikenai biaya tambahan. Hanya rate limit (HTTP 429) dan error jaringan yang diulang otomatis.

Alur tidak menjamin panggilan dilakukan tepat sekali bila terjadi gangguan di tengah jalan, dan setiap panggilan ditagih oleh provider kamu. Di loop For each, setiap item mengirim request tersendiri, jadi daftar panjang berarti satu permintaan per item.