Untuk panduan migrasi langsung ke kode yang lebih rinci, lihat panduan migrasi referensi API kami.

Seiring kami terus meningkatkan dan memperluas kemampuan AI kami, kami dengan senang hati memperkenalkan Messages API baru kami, yang menawarkan beberapa keunggulan dibandingkan Text Completions API lama kami.

Panduan ini akan membantu Anda memigrasikan aplikasi yang ada dari Text Completions API ke Messages API, memastikan transisi yang lancar dan membuka akses ke fitur dan peningkatan terbaru kami.

​
Mengapa upgrade ke Messages API?

Messages API menawarkan beberapa manfaat utama:

  1. Pemrosesan gambar: Messages API adalah satu-satunya cara untuk memproses gambar dengan Claude, memungkinkan Anda memanfaatkan kemampuan visi komputer canggih kami untuk tugas-tugas seperti klasifikasi gambar, deteksi objek, dan banyak lagi.
  2. Membangun dengan model Claude 3: Model Claude 3 terbaru dan paling kuat kami (Haiku, Sonnet, dan Opus) hanya dapat dipanggil melalui Messages API. Dengan upgrade, Anda akan dapat memanfaatkan peningkatan kinerja dan kemampuan mereka.
  3. Penanganan kesalahan yang lebih baik: Messages API memungkinkan kami mengembalikan pesan kesalahan yang lebih informatif dan membantu, memudahkan Anda untuk mendiagnosis dan menyelesaikan masalah dalam permintaan Anda.
  4. Validasi permintaan yang lebih baik: Dengan Messages API, kami dapat memvalidasi permintaan API Anda dengan lebih efektif, memastikan bahwa Anda menerima hasil dengan kualitas tertinggi dan kinerja terbaik yang mungkin dari model kami.

​
Cara upgrade ke Messages API

Cara termudah untuk upgrade dari Text Completions API ke Messages API adalah dengan menggunakan Console web kami untuk mengonversi prompt Anda. Dengan menggunakan Console, Anda dapat dengan cepat dan mudah memigrasikan prompt dan permintaan Anda ke Messages API tanpa harus menulis ulang kode secara manual.

Cukup ikuti langkah-langkah berikut:

​
1. Buka Console dan pilih model yang ingin Anda gunakan

Di dalam Console, ada panel pengaturan model di kanan bawah area pesan. Panel itu memiliki menu drop-down tempat Anda dapat memilih model yang benar untuk prompt yang dimigrasikan.

Di sinilah Anda juga dapat menyesuaikan parameter tambahan sesuai kebutuhan, seperti temperature dan jumlah token maksimum untuk disampel. Untuk informasi lebih lanjut tentang parameter kami, lihat dokumentasi Messages API.

​
2. Transfer prompt Anda ke bidang pesan Console yang sesuai

Prompt Text Completions API adalah string multi-baris yang mencakup semua bagian dari prompt, seperti prompt sistem dan giliran pengguna. Messages API memisahkan berbagai bagian prompt, seperti prompt sistem dan giliran pengguna, menjadi bidang terpisah.

Misalnya, mari kita ambil prompt Text Completions API ini:

Text
Today is March 4, 2024.

H: What are 3 ways to cook apples?

A:

Tanpa menggunakan Console, transisi prompt ini akan mengharuskan Anda untuk menulis ulang kode Anda sepenuhnya ke dalam Messages API. Namun, dengan memasukkan bagian-bagian terpisah dari prompt Anda (prompt sistem & prompt pengguna) ke dalam bidang Console yang sesuai, Anda dapat mengekstrak kode pra-format yang benar langsung dari kotak.

Di Console, prompt di atas akan terlihat seperti ini:

Perhatikan bahwa tidak ada teks Human: atau Assistant:, dan bahwa prompt sistem dan prompt pengguna berada di bidang pesan yang berbeda.

​
3. Salin kode pra-format

Setelah semua bagian prompt Anda ada di tempatnya dan parameter telah disesuaikan, klik tombol </> Get Code di kanan atas untuk melihat dan menyalin snippet kode Messages API yang sesuai, untuk Python dan TypeScript.

Untuk prompt contoh kami, output Python otomatis dari menu </> Get Code akan menjadi:

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0,
    system="Today is March 4, 2024.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "What are 3 ways to cook apples?"
                }
            ]
        }
    ]
)
print(message.content)

Catatan: Console belum memungkinkan Anda untuk mengisi respons Claude sebelumnya (yaitu, mengisi teks sebelumnya di giliran Assistant), tetapi Messages API yang mendasarinya bisa. Lihat panduan kami tentang mengisi respons Claude sebelumnya untuk contoh cara memformat permintaan Messages API dengan teknik ini.

​
Migrasi dari model lain

Jika Anda saat ini menggunakan platform atau model AI yang berbeda dan ingin beralih ke Claude dengan Messages API, kami telah membuat panduan komprehensif untuk membantu Anda melalui proses tersebut. Lihat migrasi dari model lain untuk instruksi terperinci tentang cara mengadaptasi prompt dan kode Anda ke platform kami.

​
Dokumentasi API

Untuk informasi lebih lanjut tentang Messages API dan kemampuannya, silakan lihat dokumentasi API kami:

Jika Anda memiliki pertanyaan atau memerlukan bantuan lebih lanjut dengan upgrade ke Messages API, jangan ragu untuk menghubungi tim dukungan kami. Kami di sini untuk membantu Anda memanfaatkan kemampuan AI kami sebaik mungkin dan memastikan transisi yang lancar ke Claude.

Migrasi dari model lainIkhtisar