mirror of
				https://github.com/langgenius/dify.git
				synced 2025-10-31 02:42:59 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			64 lines
		
	
	
		
			1.9 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			64 lines
		
	
	
		
			1.9 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| # Dify Node.js SDK
 | |
| This is the Node.js SDK for the Dify API, which allows you to easily integrate Dify into your Node.js applications.
 | |
| 
 | |
| ## Install
 | |
| ```bash
 | |
| npm install dify-client
 | |
| ```
 | |
| 
 | |
| ## Usage
 | |
| After installing the SDK, you can use it in your project like this:
 | |
| 
 | |
| ```js
 | |
| import { DifyClient, ChatClient, CompletionClient } from 'dify-client'
 | |
| 
 | |
| const API_KEY = 'your-api-key-here'
 | |
| const user = `random-user-id`
 | |
| const query = 'Please tell me a short story in 10 words or less.'
 | |
| const remote_url_files = [{
 | |
|     type: 'image',
 | |
|     transfer_method: 'remote_url',
 | |
|     url: 'your_url_addresss'
 | |
| }]
 | |
| 
 | |
| // Create a completion client
 | |
| const completionClient = new CompletionClient(API_KEY)
 | |
| // Create a completion message
 | |
| completionClient.createCompletionMessage({'query': query}, user)
 | |
| // Create a completion message with vision model
 | |
| completionClient.createCompletionMessage({'query': 'Describe the picture.'}, user, false, remote_url_files)
 | |
| 
 | |
| // Create a chat client
 | |
| const chatClient = new ChatClient(API_KEY)
 | |
| // Create a chat message in stream mode
 | |
| const response = await chatClient.createChatMessage({}, query, user, true, null)
 | |
| const stream = response.data;
 | |
| stream.on('data', data => {
 | |
|     console.log(data);
 | |
| });
 | |
| stream.on('end', () => {
 | |
|     console.log('stream done');
 | |
| });
 | |
| // Create a chat message with vision model
 | |
| chatClient.createChatMessage({}, 'Describe the picture.', user, false, null, remote_url_files)
 | |
| // Fetch conversations
 | |
| chatClient.getConversations(user)
 | |
| // Fetch conversation messages
 | |
| chatClient.getConversationMessages(conversationId, user)
 | |
| // Rename conversation
 | |
| chatClient.renameConversation(conversationId, name, user)
 | |
| 
 | |
| 
 | |
| const client = new DifyClient(API_KEY)
 | |
| // Fetch application parameters
 | |
| client.getApplicationParameters(user)
 | |
| // Provide feedback for a message
 | |
| client.messageFeedback(messageId, rating, user)
 | |
| 
 | |
| ```
 | |
| 
 | |
| Replace 'your-api-key-here' with your actual Dify API key.Replace 'your-app-id-here' with your actual Dify APP ID.
 | |
| 
 | |
| ## License
 | |
| This SDK is released under the MIT License.
 | 
